# List your numbers

> GET /phone-numbers. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/phone-numbers/get-phone-numbers-list-your-numbers

GET https://server.heyrik.com/api/v1/phone-numbers

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Notes

`agency_id` in the response is the agent answering inbound calls on that number — null means nobody is answering it yet.

## Request example

```sh
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"
    }
  ]
}
```