Skip to main content
POST
Send airtime

Authorizations

Authorization
string
header
required

Beem API credentials: API key as username, API secret as password.

Body

application/json
dest_addr
required

Mobile number in international format without a leading +

amount
required

Airtime amount (up to 2 decimal places)

reference_id
required

Unique client reference ID for this transfer

product_id
integer

Optional product ID for routed airtime products

Response

Successful response

code
integer
required

Status code (114 = pending, 100 = success on callback)

transaction_id
required

Beem transaction ID — use for status checks and callbacks

message
string
required

Human-readable status message