> ## 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.

# Get phone number

> Returns one phone number with its provider and the targets each side answers as. The `phoneNumberID` is the ID Voiceflow gives the number, not the number itself.



## OpenAPI

````yaml /specs-prettified/realtime/openapi.stable.json get /v1/stable/phone-number/{phoneNumberID}
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/{phoneNumberID}:
    get:
      tags:
        - Phone Number
      summary: Get phone number
      description: Returns one phone number with its provider and the targets each
        side answers as. The `phoneNumberID` is the ID Voiceflow gives the
        number, not the number itself.
      operationId: StablePhoneNumberController_get
      parameters:
        - name: phoneNumberID
          required: true
          in: path
          schema:
            type: string
          x-vf-doc:
            description: The ID of the phone number to operate on.
          description: The ID of the phone number to operate on.
        - name: workspaceID
          required: true
          in: query
          schema:
            type: string
            description: The ID of the workspace the number belongs to.
      responses:
        "200":
          description: Returns the phone number with its name, `value`, provider, and the
            `voice` and `sms` targets naming the project, environment, and
            version each side answers as.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablePhoneNumberResponse"
          x-vf-doc:
            description: Returns the phone number with its name, `value`, provider, and the
              `voice` and `sms` targets naming the project, environment, and
              version each side answers as.
      security:
        - token: []
components:
  schemas:
    StablePhoneNumberResponse:
      type: object
      properties:
        phoneNumber:
          $ref: "#/components/schemas/StablePhoneNumber"
      required:
        - phoneNumber
    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
````