Whether this organization can buy a number right now
Answers before you try: whether business verification is complete and whether the wallet covers a purchase. Cheaper than a 403 and easier to show in a UI.
Requires the read scope. A key with less gets 403 insufficient_scope.
Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/numbers/eligibility"{ "data": { "balancePaise": 0, "verified": true }}Remove the SIP trunk pair and return the number to tone_agent mode
Tears down the trunk. The number itself is kept — this is not a release.
List the organization’s numbers
Every number you hold, in any state. A suspended number still counts: suspension is unpaid rent, not a release, and it keeps your claim on the line.