GET · Bearer

GET /api/v1/phone-numbers/available?area_code=415

All endpoints · Markdown

Summary

Search US local numbers available to provision Requires inbox_read. area_code is a 3-digit US area code (HTTP 400 invalid_area_code). contains is matched against the number. limit is 1 to 20 and defaults to 5 (HTTP 400 invalid_limit). Each row is {e164, number_type, capabilities}. HTTP 404 not_found when SMS is off.

Query

?area_code=415

Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

Errors

  • HTTP 400 invalid_area_code
  • HTTP 400 invalid_limit
  • HTTP 404 not_found

Idempotency

This route does not document Idempotency-Key or client_id.