Authentication

Overview

The V1 API uses header-based authentication. Every request must include two custom headers containing your account email and API token.

Required Headers

Getting Your Credentials

V1 credentials are provisioned by the Click Airtime team — there is no self-service signup or dashboard for generating V1 API tokens.

1. Contact your Click Airtime account manager (or support@clickairtime.com) to request V1 API access
2. Once approved, your X-Click-Airtime-Email and X-Click-Airtime-Token are issued and delivered to you securely via the Click Airtime portal or email
3. Use those values as-is in every request — no further setup is required

Code Examples

curl -X GET https://api.clickairtime.com/adp/balances \
  -H "X-Click-Airtime-Email: your@email.com" \
  -H "X-Click-Airtime-Token: your-api-token"

const headers = {
  'X-Click-Airtime-Email': 'your@email.com',
  'X-Click-Airtime-Token': 'your-api-token',
};

const response = await fetch('https://api.clickairtime.com/adp/balances', {
  headers,
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-Click-Airtime-Email': 'your@email.com',
    'X-Click-Airtime-Token': 'your-api-token',
}

response = requests.get(
    'https://api.clickairtime.com/adp/balances',
    headers=headers,
)

print(response.json())

Authentication Errors

If your credentials are missing or invalid, the API returns a 401 Unauthorized response:

{
  "message": "Invalid or missing authentication credentials",
  "statusCode": 401
}

Common Issues