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

# List phone numbers

> Returns every phone number of one workspace in one response, or only those assigned to one project, each with the `voice` and `sms` targets it answers as.



## OpenAPI

````yaml /specs-prettified/realtime/openapi.stable.json get /v1/stable/phone-number
openapi: 3.0.0
info:
  title: Realtime
  description: Realtime gateway API service
  version: 1.0.0
  contact: {}
servers:
  - url: https://realtime-api.voiceflow.com
security: []
tags: []
paths:
  /v1/stable/phone-number:
    get:
      tags:
        - Phone Number
      summary: List phone numbers
      description: Returns every phone number of one workspace in one response, or
        only those assigned to one project, each with the `voice` and `sms`
        targets it answers as.
      operationId: StablePhoneNumberController_list
      parameters:
        - name: projectID
          required: false
          in: query
          schema:
            description: List only the numbers assigned to this project, for either target.
              Mutually exclusive with `workspaceID`.
            type: string
            minLength: 1
        - name: workspaceID
          required: false
          in: query
          schema:
            description: List every number the workspace holds, assigned or not. Mutually
              exclusive with `projectID`.
            type: string
            minLength: 1
      responses:
        "200":
          description: Returns the phone numbers, each with its name, `value`, provider,
            and the `voice` and `sms` targets that name the project,
            environment, and version it is assigned to (null when a side is
            unassigned).
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablePhoneNumberListResponse"
          x-vf-doc:
            description: Returns the phone numbers, each with its name, `value`, provider,
              and the `voice` and `sms` targets that name the project,
              environment, and version it is assigned to (null when a side is
              unassigned).
      security:
        - token: []
components:
  schemas:
    StablePhoneNumberListResponse:
      type: object
      properties:
        phoneNumbers:
          type: array
          items:
            $ref: "#/components/schemas/StablePhoneNumber"
          description: The matching phone numbers, each with the project, environment and
            version its `voice` and `sms` sides reach.
      required:
        - phoneNumbers
    StablePhoneNumber:
      type: object
      properties:
        id:
          type: string
          description: The ID of the phone number, used to assign, update and delete it.
            Not the number itself.
        sms:
          nullable: true
          description: Where incoming SMS go, or null when nothing handles SMS on this
            number.
          allOf:
            - $ref: "#/components/schemas/StablePhoneNumberTarget"
        name:
          type: string
          description: The display name of the number within the workspace. Callers never
            see it.
        value:
          type: string
          description: The number itself, in E.164 (e.g. `+14155552671`).
        voice:
          nullable: true
          description: Where incoming calls go, or null when nothing handles calls on this
            number.
          allOf:
            - $ref: "#/components/schemas/StablePhoneNumberTarget"
        provider:
          description: Who the number is held with. `voiceflow-telnyx` is a number bought
            through Voiceflow; the rest are numbers connected from your own
            carrier account. Fixed at creation.
          allOf:
            - $ref: "#/components/schemas/PhoneNumberProvider"
          enum:
            - twilio
            - vonage
            - telnyx
            - voiceflow-telnyx
            - voiceflow-sip
            - byo-sip
          x-enumNames:
            - TWILIO
            - VONAGE
            - TELNYX
            - VOICEFLOW_TELNYX
            - VOICEFLOW_SIP
            - BYO_SIP
        workspaceID:
          type: string
          description: The ID of the workspace the number belongs to.
        providerResourceID:
          type: string
          description: The number's ID with the provider, for reconciling against it.
        createdAt:
          type: string
          format: date-time
          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        updatedAt:
          type: string
          format: date-time
          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
      required:
        - id
        - sms
        - name
        - value
        - voice
        - provider
        - workspaceID
        - providerResourceID
        - createdAt
        - updatedAt
    StablePhoneNumberTarget:
      type: object
      properties:
        version:
          nullable: true
          description: "Which version of the environment answers: `published`, the one
            serving live traffic, or `draft`, the working copy. Null when no
            environment is pinned."
          type: string
          enum:
            - draft
            - published
          x-enumNames:
            - DRAFT
            - PUBLISHED
        projectID:
          type: string
          description: The ID of the project this side of the number reaches.
        environmentAlias:
          nullable: true
          description: "The alias of the environment this side of the number reaches (e.g.
            `main`). Null in two cases: the number is assigned to the project
            with no environment pinned, or the environment it was pinned to has
            since been deleted — `version` is still whatever the pin asked for,
            so a null alias beside a non-null `version` is the second case."
          type: string
      required:
        - version
        - projectID
        - environmentAlias
    PhoneNumberProvider:
      type: string
      enum:
        - twilio
        - vonage
        - telnyx
        - voiceflow-telnyx
        - voiceflow-sip
        - byo-sip
      x-enumNames:
        - TWILIO
        - VONAGE
        - TELNYX
        - VOICEFLOW_TELNYX
        - VOICEFLOW_SIP
        - BYO_SIP
  securitySchemes:
    token:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Voiceflow bearer token
````