<!-- Source: https://docs.vinsi.ai/api-docs/phone-numbers -->
# Get Phone Numbers

Fetch every phone number in your organization, each with its assigned agent (or null).

```http
GET https://dashboard.vinsi.ai/api/phone-numbers
```

## Authentication

Send your API key in the `x-api-key` header. Create keys in the VINSI dashboard under Settings → API Keys.

## Headers

| Name | Type | Required |
|---|---|---|
| Content-Type | string | yes (application/json) |
| x-api-key | string | yes |

## Example request

```bash
curl -X GET 'https://dashboard.vinsi.ai/api/phone-numbers' \
  -H 'x-api-key: YOUR_API_KEY'
```

## Example response

```json
[
  {
    "id": "phn_1757964000123_k2j4h5g6f",
    "phoneNumber": "+15555550199",
    "friendlyName": "Main Line",
    "providerId": "2468013579246801357",
    "provider": "telnyx",
    "capabilities": "{\"voice\":true,\"sms\":true}",
    "agentId": "cmexampleagent000000000001",
    "fallbackNumber": null,
    "isActive": true,
    "userId": "cmexampleuser0000000000001",
    "organizationId": "cmexampleorg00000000000001",
    "createdAt": "2026-09-01T18:00:00.000Z",
    "updatedAt": "2026-09-10T21:14:00.000Z",
    "SIPUserName": null,
    "SIPPassword": null,
    "SIPTerminationURI": null,
    "livekitTrunkConfigured": true,
    "trunkName": "Main Line",
    "livekitTrunkId": "ST_exampleTrunk01",
    "livekitOutboundTrunkId": null,
    "livekitOutboundConfigured": null,
    "stripeSubscriptionId": null,
    "routingMode": "agent",
    "routingDeskPhoneId": null,
    "voicemailEnabled": false,
    "voicemailPin": null,
    "huntGroupId": null,
    "queueId": null,
    "queuePriority": null,
    "livekitCluster": "vinsi-do",
    "agent": {
      "id": "cmexampleagent000000000001",
      "name": "Front Desk Agent",
      "integrations": null,
      "isAfterHoursFallback": false,
      "routeOutboundVia": "telnyx",
      "defaultOutboundPhoneNumberId": "phn_1757964000123_k2j4h5g6f"
    }
  }
]
```