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

# List the organization's verified phone numbers

> List the organization's verified phone numbers — Every phone number verified for this organization, with its status and any assigned inbound agent.



## OpenAPI

````yaml get /phone/verified-phone-numbers
openapi: 3.1.0
info:
  title: OpenCX API
  description: >

    OpenCX is an AI-powered, all-in-one platform for customer support and
    outbound communications.


    Use this API to manage your OpenCX organization's AI agents, actions,
    conversations, contacts, and more.


    To get started, generate a new API key from the dashboard.


    ## Authentication

    All API endpoints require authentication using a Bearer token. You can
    generate an API key from your OpenCX dashboard.


    ## Rate Limiting

    API requests are rate limited to ensure fair usage. The current limits are:

    - 100 requests per minute for standard endpoints

    - 1000 requests per minute for streaming endpoints


    ## Error Handling

    The API uses standard HTTP status codes and returns detailed error messages
    in the response body.
  version: 1.0-beta
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: http://localhost:8080
    description: Development
  - url: https://api.open.cx
    description: Production
security:
  - bearerAuth: []
paths:
  /phone/verified-phone-numbers:
    get:
      summary: List the organization's verified phone numbers
      description: >-
        Every phone number verified for this organization, with its status and
        any assigned inbound agent. These are the values
        setPhoneAgentCallerNumber accepts as an outbound caller ID. Purchasing
        and verifying numbers is done in the dashboard.
      operationId: listVerifiedPhoneNumbers
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListVerifiedPhoneNumbersOutput'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
components:
  schemas:
    ListVerifiedPhoneNumbersOutput:
      $schema: https://json-schema.org/draft/2020-12/schema
      $id: '#/components/schemas/ListVerifiedPhoneNumbersOutput'
      type: array
      items:
        $ref: '#/components/schemas/VerifiedPhoneNumberDto'
    ErrorDto:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        error:
          type: string
    VerifiedPhoneNumberDto:
      $schema: https://json-schema.org/draft/2020-12/schema
      $id: '#/components/schemas/VerifiedPhoneNumberDto'
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        phone_number:
          type: string
        status:
          type: string
          enum:
            - failed
            - pending
            - verified
        type:
          type: string
          enum:
            - twilio_custom_identity
            - twilio_standard_phone_number
            - twilio_whatsapp
        friendly_name:
          type:
            - string
            - 'null'
        emoji:
          anyOf:
            - type: string
              maxLength: 8
            - type: 'null'
        created_at:
          type: string
          format: date-time
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        assigned_ivr_id:
          type:
            - string
            - 'null'
        assigned_ivr_name:
          type:
            - string
            - 'null'
        assigned_agent_id:
          type:
            - string
            - 'null'
        assigned_agent_name:
          type:
            - string
            - 'null'
        assigned_agent_provider:
          anyOf:
            - type: string
              enum:
                - vapi
                - openai-realtime-voice
                - livekit
            - type: 'null'
        assigned_interpreter_id:
          type:
            - string
            - 'null'
        assigned_interpreter_name:
          type:
            - string
            - 'null'
        region:
          anyOf:
            - type: string
              enum:
                - apac
                - eu
                - us
            - type: 'null'
        twilio_phone_number_sid:
          type:
            - string
            - 'null'
      required:
        - id
        - phone_number
        - status
        - type
        - friendly_name
        - emoji
        - created_at
        - verified_at
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.