Buy data

POST 
/api/v1/data

Purchase a data plan for a phone number. The plan's price is debited from your wallet atomically — if delivery fails, you are not charged.

Pass a unique clientReference per purchase: re-sending the same one returns the original transaction instead of buying again, so a timeout is always safe to retry.

Request

Responses

200

The purchase was accepted. status is Success, Failed, or Processing.

401

Missing or invalid API key.

403

This service is not enabled for your account (e.g. airtime is disabled), or the plan is not in your catalog.

422

The request body failed validation, or your wallet has insufficient funds.