API Docs
OpenAPI spec (opens in a new tab)

Balance & Transactions

Last updated

Check your account balance and view your transaction history.

GET /v1/balance

Get your account balance in USD

curl https://api.diddysms.com/v1/balance \
  -H "Authorization: Bearer dsk_your_api_key_here"
resp = requests.get(
    "https://api.diddysms.com/v1/balance",
    headers={"Authorization": "Bearer dsk_your_api_key_here"},
)
print(resp.json())

Response

{
  "balance": 48.50,
  "currency": "USD"
}

GET /v1/transactions

List your deposits, purchases and refunds

Query parameters for listing transactions

NameTypeRequiredDescription
limitintegerNoMax results, 1-100 (default: 20)
offsetintegerNoResults offset (default: 0)
curl "https://api.diddysms.com/v1/transactions?limit=10&offset=0" \
  -H "Authorization: Bearer dsk_your_api_key_here"

Response

{
  "transactions": [
    {
      "id": 1,
      "type": "purchase",
      "amount": -1.50,
      "balance_after": 48.50,
      "description": "Number for Google",
      "reference_id": 200,
      "created_at": "2026-02-26T22:40:00Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 1
  }
}

Transaction types

TypeAmountDescription
purchasenegativeCharged when buying a number
refundpositiveCredited when an order is cancelled, expires without a code, or cannot be rented
depositpositiveFunds added to your account

Other types (for example referral credits or balance adjustments) can appear; read the sign of amount.