Numbers

Search available numbers

GET /v1/numbers/available?area_code=415

Returns up to 5 available numbers. In the sandbox this is a deterministic fake inventory; with live access it searches real US/Canada inventory across 200+ area codes.

Purchase a number

POST /v1/numbers with { "phone_number": "+1..." }

Adds the number to your account (quota applies — default 2 live numbers, 3 sandbox). Returns the Number object. Emits a number.purchased event.

List your numbers

GET /v1/numbers

Release a number

DELETE /v1/numbers/+15005550132

Marks the number released (live mode disconnects it at the carrier). Rate limited to 10 releases per 30 minutes. Emits number.released.

Live number purchase and release are part of early access review — sandbox numbers work for everyone immediately.