---
title: "List phone numbers attached to a DIR"
method: GET
path: "/dir/{dir_id}/phone_numbers"
tags: ["Phone Numbers"]
---

# List phone numbers attached to a DIR

`GET /dir/{dir_id}/phone_numbers`

List the phone numbers registered under a DIR. The enterprise is resolved server-side from the DIR id.

## Path parameters

- `dir_id` string, uuid, required

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `status` 'submitted' | 'in_review' | 'verified' | 'unsuccessful' | 'suspended' | 'expired' | 'permanently_rejected' — Phone-number lifecycle status. - `submitted` / `in_review` - Telnyx is reviewing the batch this number belongs to. - `verified` - approved; the DIR's display identity will be shown on outbound calls from this number. - `unsuccessful` - Telnyx rejected this submission; the customer may re-add to retry. - `suspended` - temporarily disabled (e.g. by an active infringement claim on the DIR). - `expired` - verification expired; re-add to renew. - `permanently_rejected` - terminal; cannot be re-added on this or any other DIR you own.

## Response `200`

Paginated list of phone numbers.

- PhoneNumberList
  - `data` DirPhoneNumber[], required
    - `id` string, uuid
    - `dir_id` string, uuid
    - `enterprise_id` string, uuid
    - `phone_number` string — E.164 with leading `+`.
    - `batch_id` string, uuid, nullable — Id of the batch this number was vetted as part of.
    - `loa_document_id` string, uuid, nullable — Id of the Letter of Authorization document attached to this number's batch.
    - `status` 'submitted' | 'in_review' | 'verified' | 'unsuccessful' | 'suspended' | 'expired' | 'permanently_rejected' — Phone-number lifecycle status. - `submitted` / `in_review` - Telnyx is reviewing the batch this number belongs to. - `verified` - approved; the DIR's display identity will be shown on outbound calls from this number. - `unsuccessful` - Telnyx rejected this submission; the customer may re-add to retry. - `suspended` - temporarily disabled (e.g. by an active infringement claim on the DIR). - `expired` - verification expired; re-add to renew. - `permanently_rejected` - terminal; cannot be re-added on this or any other DIR you own.
    - `rejection_reason` RejectionReason
      - `code` string
      - `title` string
      - `detail` string
      - `message` string, nullable — Customer-visible free-text comment from the Telnyx vetting team. Only the first entry of `rejection_reasons` carries this; the rest are `null`.
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `verified_at` string, date-time, nullable
  - `meta` BrandedCallingPaginationMeta, required — JSON:API pagination metadata returned with every paginated list response. Page numbering is 1-based. `page_size` reports the number of items actually returned in `data` for this page; the requested size is taken from the `page[size]` query parameter.
    - `total_pages` integer, required — Total number of pages available given the current `page_size`.
    - `total_results` integer, required — Total number of items across all pages (excludes soft-deleted rows).
    - `page_number` integer, required — 1-based index of this page. Echoes the `page[number]` query parameter (default `1`).
    - `page_size` integer, required — Number of items returned in this page's `data` array. Capped at 250.

## Other responses

- `default` — An error occurred. The response carries the standard Telnyx error envelope.
- `4XX` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)