Verifications

Verify a Lipa Na M-Pesa number

post/verify/lipa-na-mpesa

Verify a Kenyan M-Pesa paybill or till number.

Authorization

API key in the X-API-Key header.

Headers

Idempotency-Keystringrequired

Required for verification mutations. Use a unique printable ASCII key per logical request; retries with the same key return the original response.

Body required

identifierstringrequired

Paybill or till number to verify

identifierTypestringrequired

Whether the `identifier` is a paybill or till number

Options: paybilltill

countrystring

ISO 3166-1 alpha-2 country code. Defaults to KE.

modestring

`sync` returns the verification result in the response. `async` returns `pending` and delivers the final result via your registered webhooks (configure under `/webhooks`).

Options: syncasync

Response

idstringrequired

statusstringrequired

Options: pendingsuccessfailederrorinconclusive

verificationTypestringrequired

Options: LIPA_NA_MPESA

identifierstringrequired

Paybill or till number

countrystringrequired

verifiedAtstring | nullrequired

verifiedboolean | nullrequired

originstringrequired

Where this verification was initiated. `api` = Lira API key (machine-to-machine). `dashboard` = logged-in dashboard user.

Options: apidashboard

organizationShortCodestring | nullrequired

organizationNamestring | nullrequired

Registered organization name

identifierTypestring | nullrequired

errorobject | nullrequired

Populated only when status is `failed` or `error`

Show child attributes

codestringrequired

messagestringrequired

curl -X POST 'https://api.lira.com/api/v1/verify/lipa-na-mpesa' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "identifier": "247247", "identifierType": "paybill", "country": "KE", "mode": "sync" }'

const response = await fetch('https://api.lira.com/api/v1/verify/lipa-na-mpesa', { method: 'POST', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ "identifier": "247247", "identifierType": "paybill", "country": "KE", "mode": "sync" }), }); const data = await response.json();

import requests response = requests.post( "https://api.lira.com/api/v1/verify/lipa-na-mpesa", headers={"X-API-Key": "YOUR_API_KEY"}, json={ "identifier": "247247", "identifierType": "paybill", "country": "KE", "mode": "sync" }, ) data = response.json()

{ "id": "f6a7b8c9-d0e1-2345-fabc-678901234567", "status": "success", "verificationType": "LIPA_NA_MPESA", "identifier": "247247", "country": "KE", "verifiedAt": "2026-04-22T10:15:30.000Z", "verified": true, "origin": "api", "organizationShortCode": "247247", "organizationName": "KCB Bank Kenya", "identifierType": "paybill", "error": { "code": "PAYBILL_NOT_FOUND", "message": "Paybill or till number not found" } }

{ "message": "NG Account Number verification is not enabled for your organisation.", "code": "SERVICE_NOT_ENABLED", "action": { "type": "CONTACT_ADMIN", "hint": "Ask your administrator to enable NG Account Number verification in the Lira dashboard." } }