Search every carrier for numbers available to buy (cursor-paginated)

Asks every carrier Tone sells from and lists their numbers together, cheapest first. Each result names its provider — pass it back when you buy, and the number is bought from and operated by that carrier. Pass provider here to list one carrier’s numbers only (GET /v1/numbers/carriers names them). If one carrier is unreachable the others still list; if nothing lists and a carrier failed, that failure is returned rather than an empty list. Page with meta.pagination.cursor, sending the same filters with it. Every page is sorted cheapest first; carriers are read a page at a time, so a later page can occasionally hold a cheaper number than an earlier one, and a page can hold fewer than limit results while hasMore is still true. The first page carries meta.pagination.total, how many numbers the whole search lists, when every carrier searched can count it; it is the carriers’ own count where they page, so a walk can end a little short of it, and it is left out when a carrier cannot count a circle (VoiceLink) or failed. Live inventory, so results go stale — a number can be taken between this call and your purchase, which is a 409 number_unavailable, and a number sold between two pages can shift a carrier's listing by one. Only regular numbers are offered: the 140 and 160 series are not purchasable through any carrier API.

curl -X GET "https://example.com/v1/numbers/available"

{  "data": [    {      "capabilities": {        "sms": false,        "voice": true      },      "e164": "+918045678901",      "numberType": "landline",      "provider": "exotel",      "region": "KA",      "renewalCycle": "anniversary",      "renewsAt": "2026-10-31T18:30:00Z",      "rentalPaise": 0,      "setupPaise": 0,      "totalPaise": 0    }  ]}