List phone numbers

Returns all phone numbers provisioned for the workspace.

GET /api/v2/phone-numbers

List phone numbers

cURL

curl --request GET \
  --url https://api.heymilo.ai/api/v2/phone-numbers \
  --header 'X-API-KEY: <api-key>'

200

{
  "data": [
    {
      "id": "<string>",
      "phone_number": "<string>",
      "active": true,
      "object": "phone_number",
      "country_code": "US",
      "date_provisioned": 1739612400
    }
  ],
  "pagination": {
    "has_more": true,
    "total_count": 123,
    "url": "<string>"
  }
}

Authorizations

X-API-KEY · string · header · required

API key for authentication. Pass your key in the X-API-KEY header.

Headers

X-API-KEY · string | null

Authorization · string | null

X-Workspace-Id · string | null

Query Parameters

limit · integer · default: 20

Required range: 1 <= x <= 100

starting_after · string | null

Response

200

application/json

Successful Response

data · PhoneNumberResponse · object[] · required

Show child attributes

pagination · PaginationMeta · object · required

Show child attributes