Skip to main content

List phone numbers

GET 
/api/v1/domains/:domain_uuid/phone-numbers

Returns phone numbers for the specified domain the caller is allowed to access.

Access rules:

  • Caller must have access to the target domain (domain scope).
  • Caller must have the destination_domain permission.

Pagination (cursor-based):

  • Both limit and starting_after are optional.
  • If limit is not provided, it defaults to 50.
  • If starting_after is not provided, results start from the beginning.
  • If has_more is true, request the next page by passing starting_after equal to the last item's destination_uuid from the previous response.

Examples:

  • First page: GET /api/v1/domains/{domain_uuid}/phone-numbers
  • Next page: GET /api/v1/domains/{domain_uuid}/phone-numbers?starting_after={destination_uuid}
  • Custom size: GET /api/v1/domains/{domain_uuid}/phone-numbers?limit=50

Request​

Responses​

Success