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

# Get all phone numbers

> Get all phone numbers owned by the authenticated user

This endpoint returns a list of all phone numbers associated with your account, including their subscription status and capabilities.

### Response

**data** `array`

Array of phone number objects

**phone number properties**

**id** `integer`

The unique identifier of the phone number

**phone\_number** `string`

The phone number in E.164 format (e.g., +14155551234)

**country\_code** `string`

The ISO 3166-1 alpha-2 country code (e.g., US, GB, AU)

**type** `string`

The type of phone number: `normal`, `sip`, or `caller_id`

**type\_label** `string`

Human-readable label for the phone number type

**sms\_capable** `boolean`

Whether the phone number can send and receive SMS

**region** `string`

The region where the phone number is provisioned

**has\_active\_subscription** `boolean`

Whether the phone number has an active subscription

**created\_at** `string`

ISO 8601 timestamp of when the phone number was purchased

```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]
>
> There is also a legacy endpoint `GET /user/phone-numbers` that returns only SMS-capable phone numbers with active subscriptions. Use this `/all` endpoint if you need all phone numbers regardless of SMS capability or subscription status.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.