# GET /api/v1/phone-numbers

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/list-phone-numbers

## Summary

List the account's active phone numbers Requires inbox_read. An inbox-scoped key lists only that inbox. Returns {object:"list", data:[phone numbers]}. HTTP 404 not_found when SMS is off.

## Request

This call has no JSON body.

## Response

HTTP 200. Sample values illustrate the schema.

```json
{
  "object": "list",
  "data": [
    {
      "object": "phone_number",
      "id": "inb_example",
      "account_id": "acc_example",
      "e164": "+14155550100",
      "provider": "string",
      "provider_sid": "string",
      "number_type": "string",
      "capabilities": [
        "string"
      ],
      "status": "pending",
      "outbound": "string",
      "created_at": "2026-10-18T12:00:00.000Z"
    }
  ]
}
```

## Errors

- HTTP 404 not_found

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "not_found",
    "code": "not_found",
    "docs_url": "https://cooperemail.com/docs#not_found"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.