REST API

Authentication: Authorization: Bearer YOUR_API_KEY

GET /api/v1/balance

Read account principal and bonus balances.

{
  "success": true,
  "data": {
    "principal_balance": 100.0,
    "bonus_balance": 10.0,
    "currency": "USD"
  }
}

GET /api/v1/products

Query products synced from HeroSMS. Optional query: q.

POST /api/v1/orders

Create a single SMS verification order. You may pass callback_url and callback_secret for this order.

{
  "country_id": 196,
  "service_code": "wa",
  "operator_code": "singtel",
  "callback_url": "https://example.com/hook",
  "callback_secret": "secret"
}

GET /api/v1/orders/{uuid}

Read a single order.

POST /api/v1/orders/{uuid}/refresh

Force a supplier status refresh.