List your numbers

GEThttps://server.heyrik.com/api/v1/phone-numbers

Headers

AuthorizationstringRequired

Use Bearer $HEYRIK_API_KEY with an account-scoped API key. Keep the key on your server.

Get your API key

Response

Explore the example values. This is not a complete response schema.

dataarray

Explore 1 example item

[0]object

Explore 9 properties

idstring

Example "sip_45723ca5"

namestring

Example "+918071578563"

phone_numberstring

Example "+918071578563"

providerstring

Example "managed"

managedboolean

Example true

agency_idstring

Example "agc_9f2a1c30"

directionstring

Example "both"

activeboolean

Example true

renews_atstring

Example "2026-08-20T10:25:30.672Z"

Error reference

GET/phone-numbers

cURL

curl https://server.heyrik.com/api/v1/phone-numbers \
  -H "Authorization: Bearer $HEYRIK_API_KEY"

Response example

JSON

{
  "data": [
    {
      "id": "sip_45723ca5",
      "name": "+918071578563",
      "phone_number": "+918071578563",
      "provider": "managed",
      "managed": true,
      "agency_id": "agc_9f2a1c30",
      "direction": "both",
      "active": true,
      "renews_at": "2026-08-20T10:25:30.672Z"
    }
  ]
}

Illustrative examples · No live request is sent