Airtime Purchase
POST
/v1/airtime-purchase
Sample request
{
{
"originatorConversationId": "{{$guid}}",
"callbackURL": "https://en1ezbmu2vsd.x.pipedream.net",
"recipients": [
{
"currencyCode": "KES",
"phoneNumber": "254700000000",
"amount": 99,
"name": "Jojo Siwa"
}
]
}Sample response
{
{
"message": {
"systemConversationId": "01000000-0105-0a00-6bc1-08de9bedbeee",
"originatorConversationId": "01000000-0105-0a00-6bc1-08de9bedbee",
"remarks": "Airtime Purchase Accepted",
"timestamp": "2026-04-16T19:24:15.3381289Z",
"appDomainName": "TEST"
}
}Data Definition
| Field name | Data type | Options |
|---|---|---|
| recipientName | string | mandatory |
| recipientPhoneNumber | string | mandatory |
| recipientccy | string | mandatory |
| amount | integer | mandatory |
| callBackUrl | string | mandatory |
Description
Request
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/airtime-purchase' \
--header 'Content-Type: application/json' \
--data-raw '{
"originatorConversationId": "string",
"callbackURL": "http://example.com",
"recipients": [
{
"currencyCode": "string",
"phoneNumber": "string",
"amount": 0,
"name": "string"
}
]
}'Response Response Example
{}Modified at 2026-04-30 06:30:30