numo

Developer API

REST v1 for catalog browse, wallet balance, and automated number rental.

Authentication

Authorization: Bearer numo_xxxxxxxx

Create keys in Account → API keys. Never share your secret.

Endpoints

  • GET https://your-numo-host/api/v1/services?q=telegram&page=1
  • GET https://your-numo-host/api/v1/services/telegram
  • GET https://your-numo-host/api/v1/wallet
  • POST https://your-numo-host/api/v1/orders
  • GET https://your-numo-host/api/v1/orders/:id — status + received sms[]
  • POST https://your-numo-host/api/v1/orders/:id/cancel — auto-refund
  • POST https://your-numo-host/api/v1/orders/:id/finish

Buy a number

POST /api/v1/orders
{
  "service": "telegram",
  "country": "england",
  "operator": "any",
  "idempotencyKey": "your-unique-id"
}
Manage API keys →