Documentation
Everything you need to integrate the LATITUDE 235 IT API.
Authentication
All API requests require your API key in the x-api-key header. Find your key in API Keys.
// Add to every request
headers: { "x-api-key": "lat235_live_your_key_here" }
Base URL:
https://65nbuot5qf.execute-api.af-south-1.amazonaws.com/prod
GET
/v1/validate/phone
Validate any African mobile phone number. Returns country, carrier, dial code, mobile money support and number type.
// Request
GET /v1/validate/phone?number=+254712345678
// Response
{ "valid": "true", "country": "Kenya",
"carrier": "Safaricom", "mobile_money": "true",
"dial_code": "+254", "type": "mobile" }
| Parameter | Type | Required | Description |
|---|---|---|---|
| number | string | required | Phone number with country code e.g. +27821234567 |
GET
/v1/banks
Look up any African bank by SWIFT code. Returns bank name, country and mobile money support flag.
// Request
GET /v1/banks?swift=MPESAKEN
// Response
{ "bank": "M-Pesa (Safaricom)", "country": "Kenya",
"country_code": "KE", "mobile_money": "true" }
| Parameter | Type | Required | Description |
|---|---|---|---|
| swift | string | required | SWIFT/BIC code of the bank e.g. GTBINGLA |
Error responses
| Status | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad request — missing or invalid parameters |
| 403 | Forbidden — invalid or missing API key |
| 404 | Not found — bank SWIFT code not in database |
| 422 | Invalid number — phone number failed validation |
| 429 | Too many requests — monthly call limit reached |
| 500 | Server error — try again later |