1. [    Home ](/)
2. [Guides](/guides)
3. [Getting Started](/guides?category=26)
4. Making Your First API Call with cURL
 
 beginner Getting Started      10 min       3 steps      6 min read  

# Making Your First API Call with cURL

  A  admin  April 15, 2026  

 

 

       

 

 

 

 

 ##     Prerequisites 

 

 

 

 

 ## On this page

  
  3 steps total 

 [    Back to top ](#main-content) 

 ## Prerequisites

You will need cURL installed (curl --version to check) and an API key from the Developer Portal.

## Step 1 — Set Your Environment Variables

Store credentials as shell variables so you don't paste them repeatedly:

export AELIX\_API\_KEY="your-api-key-here"  
export AELIX\_BASE\_URL="<https://api.aelix.digitalapi.ai>"

## Step 2 — Make a GET Request

Let's call the ATM Locator API to find ATMs near a postcode:

curl -s \\  
 -H "Authorization: Bearer $AELIX\_API\_KEY" \\  
 -H "Accept: application/json" \\  
 "$AELIX\_BASE\_URL/v1/atm-locator?postcode=EC2V7AN&amp;radius=500"

A successful response returns a JSON array of ATM locations:

{  
 "data": \[  
 {  
 "atm\_id": "ATM-001-UK",  
 "address": "1 Cheapside, London EC2V 7AN",  
 "latitude": 51.5145,  
 "longitude": -0.0928,  
 "accessibility": \["wheelchair", "braille\_keypad"\],  
 "currency\_available": \["GBP"\]  
 }  
 \],  
 "total": 3  
}

## Step 3 — Make a POST Request

To create a resource, use POST with a JSON body:

curl -s -X POST \\  
 -H "Authorization: Bearer $AELIX\_API\_KEY" \\  
 -H "Content-Type: application/json" \\  
 -H "Accept: application/json" \\  
 -d '{  
 "account\_type": "current",  
 "currency": "GBP",  
 "nickname": "Main Operating Account"  
 }' \\  
 "$AELIX\_BASE\_URL/v1/accounts"

### Tips

- Add -i to include response headers in the output
- Use | jq . to pretty-print JSON responses
- Use -v for full request/response debugging



 

 

 

 ### Tags

Tags

[REST](/taxonomy/term/36)