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

# List Phone Numbers

> Retrieve every phone number provisioned in your workspace, including capabilities, nickname, and the assigned inbound agent.

<Warning>
  **Legacy endpoint - deprecated.** Unversioned endpoints are scheduled for removal on **July 31, 2026**. Use the [`/v1` version](/docs/api-reference/v1/phone-numbers/list) for new integrations. This endpoint remains available for existing integrations until then.
</Warning>

Returns every phone number provisioned in your workspace, paginated. Each entry includes the E.164 `phone_number`, the `country_code`, the `type` (local, toll-free, or mobile), the display `nickname`, the `inbound_agent_id` currently routing incoming calls on this number, and the purchase timestamp. Use this to power a number management view, audit which numbers are in use, or sync your DialNexa number portfolio with an internal inventory.

## When to use this

* **Number management UIs**: render a table of every number with status, type, and assigned agent.
* **Routing audits**: confirm every active number has an agent assigned, or surface unrouted numbers as a follow-up task.
* **Cost reporting**: aggregate by `country_code` or `type` to attribute telephony spend per workspace, region, or use case.
* **Operational scripts**: enumerate numbers before applying a bulk reassignment through [Update Phone Number](/docs/api-reference/phone-numbers/update).

## Query parameters

| Parameter      | Description                                                                          |
| -------------- | ------------------------------------------------------------------------------------ |
| `page`         | Page number, starting from 1.                                                        |
| `limit`        | Results per page (max 100, default 20).                                              |
| `country_code` | Filter to numbers in a specific country, for example `IN` or `US`.                   |
| `type`         | Filter to numbers of a specific type, for example `local`, `toll_free`, or `mobile`. |

## Errors

* `403 Forbidden` is returned when the API key cannot read phone number records.

## Related endpoints

* [Get Phone Number](/docs/api-reference/v1/phone-numbers/get): fetch a single number's detail.
* [Buy a Phone Number](/docs/api-reference/v1/phone-numbers/buy): purchase a new number.
* [Update Phone Number](/docs/api-reference/phone-numbers/update): change nickname or reassign inbound agent.
* [Release a Number](/docs/api-reference/v1/phone-numbers/delete): release a number back to the provider's pool.
* [Pagination](/docs/api-reference/pagination): how DialNexa list endpoints paginate.


## OpenAPI

````yaml GET /organization-phone-numbers
openapi: 3.0.0
info:
  title: DialNexa API
  description: >-
    Public REST API for the DialNexa voice AI platform. Versioned endpoints are
    under /v1; unversioned endpoints are legacy and deprecated.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: API Keys
  - name: Agent Functions
  - name: Agents V1
  - name: Agents2
  - name: Batch Calls
  - name: Batch Calls V1
  - name: Call Logs
  - name: Calls
  - name: Calls V1
  - name: Campaign Leads
  - name: Campaigns
  - name: External Webhooks
  - name: Knowledge Base
  - name: Knowledge Base V1
  - name: LLMs
  - name: LLMs V1
  - name: Languages
  - name: Languages V1
  - name: Organization Phone Numbers
  - name: Organization Phone Numbers V1
  - name: Phone Number Pricing
  - name: Phone Number Pricing V1
  - name: Transcribers
  - name: Transcribers V1
  - name: User Webhooks
  - name: User Webhooks V1
  - name: V1
  - name: Voices
  - name: Voices V1
  - name: Webcall
  - name: Workflow Leads
  - name: Workflow Leads V1
  - name: Workflows
  - name: Workflows V1
paths:
  /organization-phone-numbers:
    get:
      tags:
        - Organization Phone Numbers
      summary: Get all organization phone numbers (paginated)
      description: >-
        **Legacy endpoint - deprecated, scheduled for removal on July 31,
        2026.** Use the `/v1` version for new integrations. 


        Returns a paginated list of all phone numbers registered in the system,
        supporting pagination (page, limit) and sorting (sortBy, sortOrder).
        Results include phone number details regardless of which telephony
        provider they belong to.
      operationId: OrganizationPhoneNumbersController_findAll
      parameters:
        - name: sortOrder
          required: false
          in: query
          schema:
            enum:
              - ASC
              - DESC
            type: string
        - name: sortBy
          required: false
          in: query
          schema:
            type: string
        - name: limit
          required: true
          in: query
          schema:
            type: number
        - name: page
          required: true
          in: query
          schema:
            type: number
      responses:
        '200':
          description: List of phone numbers with pagination.
      deprecated: true
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````