> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intellixent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get phone numbers

> Retrieve all phone numbers on your account.

Returns all phone numbers associated with your account, including their type, capabilities, and subscription status.

## Endpoint

`GET /user/phone-numbers/all`

## Response

<ResponseField name="data" type="array">
  Array of phone number objects.

  <Expandable title="Phone number properties">
    <ResponseField name="id" type="integer">Unique identifier of the phone number.</ResponseField>
    <ResponseField name="phone_number" type="string">Phone number in E.164 format (e.g., `+14155551234`).</ResponseField>
    <ResponseField name="country_code" type="string">ISO 3166-1 alpha-2 country code (e.g., `US`, `GB`).</ResponseField>
    <ResponseField name="type" type="string">Type of phone number: `normal`, `sip`, or `caller_id`.</ResponseField>
    <ResponseField name="type_label" type="string">Human-readable type label.</ResponseField>
    <ResponseField name="sms_capable" type="boolean">Whether the number supports SMS.</ResponseField>
    <ResponseField name="region" type="string">Region where the number is provisioned.</ResponseField>
    <ResponseField name="has_active_subscription" type="boolean">Whether the number has an active subscription.</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp when the number was purchased.</ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://portal.intellixent.ai/api/user/phone-numbers/all" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://portal.intellixent.ai/api/user/phone-numbers/all', {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });

  const data = await response.json();
  console.log(data.data); // Array of phone numbers
  ```
</CodeGroup>

```json 200 Response theme={null}
{
  "data": [
    {
      "id": 1,
      "phone_number": "+14155551234",
      "country_code": "US",
      "type": "normal",
      "type_label": "Dedicated Number",
      "sms_capable": true,
      "region": "us1",
      "has_active_subscription": true,
      "created_at": "2025-01-08T10:30:00.000000Z"
    },
    {
      "id": 2,
      "phone_number": "+442071234567",
      "country_code": "GB",
      "type": "normal",
      "type_label": "Dedicated Number",
      "sms_capable": false,
      "region": "us1",
      "has_active_subscription": true,
      "created_at": "2025-01-05T14:20:00.000000Z"
    }
  ]
}
```

<Note>
  This endpoint returns all phone numbers regardless of SMS capability or subscription status. Use it when you need a complete view of your account's phone numbers.
</Note>