Mobile Number Lookup API

Authentication

Every request requires your API key in the headers.

Required Headers

Content-Type application/json

Header Name x-api-key

Alternative Authorization: Bearer KEY

Mobile Number Lookup

Verify mobile money account holders before sending payouts. Confirm name matches and reduce failed transactions with our name enquiry service.

POST https://speedpesa.com/api/v1/numberprevious

Request Body (JSON)

Field	Type	Required	Description
`phonenumber`	string	Yes	Customer phone: `2557XXXXXXXX`

cURL Example

curl -X POST https://speedpesa.com/api/v1/numberprevious \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "phonenumber": "255617919056" }'

JSON Response

Success Error

{ "type": "success", "data": { "reference": "DSXPNE1Y2F", "accountnumber": "255687819056", "accountname": "JOSEPH", "channelprovider": "AIRTEL MONEY", "created": "2026-06-23 10:01:38" } }

{ "type": "error", "message": "Invalid phone number format", "data": { "error_code": "phone_invalid_format" } }