> ## 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 Number Pricing

> List DialNexa phone number rental pricing by telephony provider and country before provisioning a number.

<span data-api-safety-label="read-only"><Badge color="gray" size="sm" shape="pill">Read only</Badge></span>

List phone number pricing to compare the credit cost of renting numbers by telephony provider and country. Pricing is reference data and does not reserve inventory or charge the workspace.

## When to list phone number pricing

* Estimate rental cost before searching provider inventory.
* Compare country availability across supported telephony providers.
* Display current credit pricing in an internal provisioning workflow.

## Verify the result

Match `telephony_provider_id` and `country_iso` to the provider and country you plan to use. Read `credit_cost` as a decimal credit amount. Re-read pricing immediately before a purchase because reference pricing can change.

<Warning>
  This read-only operation does not prove that a number is currently available. Search inventory before purchasing, and verify the final purchase response before recording a cost.
</Warning>

## Errors and recovery

* `401 Unauthorized` means the API key is missing or invalid.
* An empty array means no current pricing records are available. Do not fall back to a previously cached price for an automated purchase.

## Related endpoints

* [Search Available Numbers](/docs/api-reference/v1/phone-numbers/search-plivo): find numbers currently available from the provider.
* [Buy a Phone Number](/docs/api-reference/v1/phone-numbers/buy): provision a selected number.
* [List Phone Numbers](/docs/api-reference/v1/phone-numbers/list): verify numbers already owned by the workspace.


## OpenAPI

````yaml GET /v1/phone-number-pricing
openapi: 3.0.0
info:
  title: DialNexa API
  description: Public `/v1` REST API for the DialNexa voice AI platform.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: Agents
  - name: Batch Calls
  - name: Calls
  - name: Knowledge Base
  - name: Languages
  - name: LLMs
  - name: Phone Numbers
  - name: Transcribers
  - name: Webhooks
  - name: Voices
  - name: Workflows
  - name: Workflow Leads
paths:
  /v1/phone-number-pricing:
    get:
      tags:
        - Phone Numbers
      summary: List Phone Number Pricing
      description: Returns phone number rental pricing by telephony provider and country.
      operationId: listPhoneNumberPricing
      responses:
        '200':
          description: Phone number pricing returned successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PhoneNumberPricing'
        '401':
          description: Unauthorized - missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearer: []
components:
  schemas:
    PhoneNumberPricing:
      type: object
      properties:
        telephony_provider_id:
          type: string
          example: tp_abc123xyz789
        country_iso:
          type: string
          minLength: 2
          maxLength: 3
          example: IN
        country_name:
          type: string
          example: India
        credit_cost:
          oneOf:
            - type: number
              format: double
            - type: string
          example: '500.0000'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        telephonyProvider:
          type: object
          additionalProperties: true
          description: Associated telephony provider metadata.
      required:
        - telephony_provider_id
        - country_iso
        - country_name
        - credit_cost
    ErrorResponse:
      type: object
      properties:
        statusCode:
          type: integer
          example: 400
        message:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: phone_number must be a valid E.164 phone number
        error:
          type: string
          example: Bad Request
      required:
        - statusCode
        - message
        - error
  securitySchemes:
    bearer:
      scheme: bearer
      type: http

````