Billing & balance endpoints

Endpoints for credit purchases and ledger transactions.

GET/v1/purchases

List credit purchase requests.

AuthPortal token
Request sampleGET /v1/purchases
No request body.
Response sample200 OK
[
  {
    "id": "pur_123",
    "sms_count": 1000,
    "status": "pending"
  }
]
POST/v1/purchases

Create a credit purchase request.

AuthPortal token
Parameters
NameTypeDescriptionRequired
sms_countnumberRequested SMS credits.Yes
Request samplePOST /v1/purchases
{
  "sms_count": 1000
}
Response sample200 OK
{
  "id": "pur_123",
  "sms_count": 1000,
  "status": "pending"
}
GET/v1/credits/transactions

List credit ledger transactions.

AuthPortal token
Request sampleGET /v1/credits/transactions
No request body.
Response sample200 OK
[
  {
    "id": "txn_123",
    "type": "manual_credit",
    "amount": 1000,
    "balance_after": 2500
  }
]