SpeedPesa Pro
SpeedPesa Pro API v1

Mobile Number Lookup API

Verify the number and provider before a transaction.

LOOKUP · POSTYou ask (POST) which network a phone number belongs to before sending money.
HomeDocumentationNumber Lookup

Authentication

Every request requires your API key in the headers.

Required Headers

Authorization

Bearer sk_live_XXXXXXXXXXXX

Content-Type

application/json

Overview

Identify the wallet of a phone number before sending a collection or payout to reduce failed transactions.

POST

Mobile Number Lookup

Verify a phone number and identify its provider (wallet) before sending a collection or payout. This reduces failed transactions caused by incorrect numbers.

POST https://www.speedpesapro.com/api/public/v1/lookup

Use www.speedpesapro.com specifically (without www the request is redirected and some HTTP clients drop the POST body — which causes a server error).

Request Body (JSON)

ParameterTypeRequiredDescription
phonestringYesThe phone number to verify (07XXXXXXXX or 2557XXXXXXXX).example: 0712345678
bash
curl -X POST 'https://www.speedpesapro.com/api/public/v1/lookup' \
  -H 'Authorization: Bearer sk_live_XXXXXXXXXXXX' \
  -H 'Content-Type: application/json' \
  -d '{ "phone": "0712345678" }'

Note: Recognised wallets: M-Pesa, Mixx By Yas (Tigo Pesa), Airtel Money and Halopesa.

Balance Check APIWebhook API