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

# Retrieve a WhatsApp phone number

> Returns one WhatsApp phone number linked to the authenticated Telnyx account. For a coexistence number in the `syncing` state, the response includes `sync_progress`.



## OpenAPI

````yaml /openapi/source/external/legacy-published/whatsapp/management.json get /whatsapp/phone_numbers/{phone_number}
openapi: 3.1.0
info:
  contact:
    email: support@telnyx.com
  description: >
    API for managing WhatsApp Business Accounts (WABAs), phone numbers, and
    message templates.


    Use these endpoints to:

    - List and manage WhatsApp Business Accounts

    - Configure phone numbers for WhatsApp

    - Create and manage message templates

    - Set up webhook configurations
  title: Telnyx WhatsApp Management API
  version: 2.0.0
servers:
  - url: https://api.telnyx.com/v2
security:
  - bearerAuth: []
paths:
  /whatsapp/phone_numbers/{phone_number}:
    get:
      tags:
        - Whatsapp Phone Numbers
      summary: Retrieve a WhatsApp phone number
      description: >-
        Returns one WhatsApp phone number linked to the authenticated Telnyx
        account. For a coexistence number in the `syncing` state, the response
        includes `sync_progress`.
      operationId: GetWhatsappPhoneNumber
      parameters:
        - $ref: '#/components/parameters/WhatsappPhoneNumber'
      responses:
        '200':
          $ref: '#/components/responses/WhatsappPhoneSingleResponse'
        4XX:
          $ref: '#/components/responses/messaging_GenericErrorResponse'
components:
  parameters:
    WhatsappPhoneNumber:
      name: phone_number
      in: path
      required: true
      schema:
        type: string
      description: Phone number (E.164 format)
  responses:
    WhatsappPhoneSingleResponse:
      description: Successful response with one WhatsApp phone number
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                $ref: '#/components/schemas/WhatsappPhoneResponse'
            required:
              - data
    messaging_GenericErrorResponse:
      description: Unexpected error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/messaging_Errors'
          example:
            errors:
              - code: string
                title: string
                detail: string
                source:
                  pointer: /data/attributes/phone_number
                  parameter: string
  schemas:
    WhatsappPhoneResponse:
      type: object
      properties:
        record_type:
          type: string
          example: whatsapp_business_phone_number
        phone_number:
          type: string
          description: Phone number in E164 format
        phone_number_id:
          type: string
          description: Whatsapp phone number ID
        waba_id:
          type: string
          description: WABA ID of Whatsapp business account
        user_id:
          type: string
          description: User ID
        display_name:
          type: string
        quality_rating:
          type: string
          description: Whatsapp quality rating
        status:
          type: string
        created_at:
          type: string
          format: date-time
        enabled:
          type: boolean
        calling_enabled:
          type: boolean
        is_on_biz_app:
          type: boolean
          description: >-
            Indicates whether the number is connected to both the WhatsApp
            Business app and Cloud API through WhatsApp Coexistence.
        coexistence_state:
          type:
            - string
            - 'null'
          enum:
            - pending_onboarding
            - sync_pending
            - syncing
            - sync_complete
            - active
            - history_declined
            - sync_deadline_expired
            - offboarded
            - disconnected
            - null
          description: >-
            Current lifecycle state for a coexistence number. This is null for a
            standard Cloud API number.
        sync_deadline:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Deadline for initiating the current coexistence synchronization
            cycle. This is null when no deadline applies.
        sync_progress:
          type:
            - object
            - 'null'
          description: >-
            Synchronization progress. This object is returned only while a
            coexistence number is synchronizing.
          properties:
            contacts_status:
              type: string
            history_status:
              type: string
            history_phase:
              type:
                - integer
                - 'null'
            history_chunk_order:
              type:
                - integer
                - 'null'
            history_progress:
              type:
                - integer
                - 'null'
              minimum: 0
              maximum: 100
    messaging_Errors:
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/messaging_Error'
    messaging_Error:
      required:
        - code
        - title
      properties:
        code:
          type: string
          x-format: integer
        title:
          type: string
        detail:
          type: string
        source:
          type: object
          properties:
            pointer:
              description: JSON pointer (RFC6901) to the offending entity.
              type: string
              format: json-pointer
            parameter:
              description: Indicates which query parameter caused the error.
              type: string
        meta:
          type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````