---
title: Phone Numbers | API Docs
description: Discover and monitor the phone numbers provisioned on your account.
---

Every outbound message is sent `from` a phone number provisioned on your account. This guide covers how to discover those numbers programmatically and watch for status changes.

## List your phone numbers

List every number assigned to the authenticated partner. See the [List Phone Numbers API reference](/api/resources/phone_numbers/methods/list/index.md) for the full endpoint specification.

Terminal window

```
curl https://api.linqapp.com/api/partner/v3/phone_numbers \
  -H "Authorization: Bearer $LINQ_API_KEY"
```

```
const { phone_numbers } = await client.phoneNumbers.list();


for (const pn of phone_numbers) {
  console.log(pn.phone_number); // e.g. "+12223334444"
}
```

```
result = client.phone_numbers.list()
for pn in result.phone_numbers:
    print(pn.phone_number)
```

Use the returned `phone_number` values as the `from` field when [creating a chat](/api/resources/chats/methods/create/index.md), listing chats, or [sending a voice memo](/guides/messaging/voice-memos/index.md).

## Provisioning

Numbers are provisioned by your Linq representative — there is no self-serve create or delete endpoint on the V3 API. To add or release a line, contact support with the details of the line you want changed.

## Status changes

Numbers have a runtime status:

- **`ACTIVE`** — healthy and sending/receiving normally
- **`FLAGGED`** — a service flag has degraded the number’s ability to send. New messages on a flagged line may fail with delivery errors.

Status transitions are delivered via the [`phone_number.status_updated`](/guides/webhooks/events#phone-number-events/index.md) webhook. Subscribe to this event if your application relies on specific lines staying healthy.

```
{
  "phone_number": "+12025551234",
  "previous_status": "ACTIVE",
  "new_status": "FLAGGED",
  "changed_at": "2026-02-18T18:35:05.000Z"
}
```

You can also enable **Flagged-number Slack notifications** in the [API Tooling](https://dashboard.linqapp.com/api-tooling/phone-numbers) settings to get a Slack message in your linked partner channel whenever a number’s status changes.

**Recommended handling:**

- Page on-call when a production line transitions to `FLAGGED`
- Pause outbound sends on the affected line until it returns to `ACTIVE`
- Contact your Linq representative for remediation

## Related

- [Key Concepts: Phone Numbers](/getting-started/key-concepts#phone-numbers/index.md)
- [Webhooks: Phone number events](/guides/webhooks/events#phone-number-events/index.md)
- [API Reference: Phone Numbers](/api/resources/phone_numbers/index.md)