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

# List Fax Phone Numbers

> Fax lines available as the "From" number in the compose form.

Fax-permissioned twin of the settings ``GET /admin/phone-numbers?type=FAX``
endpoint. That one is gated by AI-assistant read, so a fax-only user 403s
there and the compose form wrongly renders "No fax line configured."

Declared above ``GET /faxes/{fax_id}`` on purpose — same declaration-order
hazard the ``unread-count`` route above documents, else ``{fax_id}`` would
swallow ``phone-numbers`` and 404.

Returns a sparse ``PhoneNumberSummary`` (assistant/ring-group fields left at
their schema defaults) so a fax-only role can't enumerate the tenant's
voice/assistant topology through this endpoint.



## OpenAPI

````yaml get /faxes/phone-numbers
openapi: 3.1.0
info:
  title: Decoda API
  description: External API documentation for the Decoda Health platform.
  version: '1.0'
servers: []
security: []
paths:
  /faxes/phone-numbers:
    get:
      tags:
        - Faxes
      summary: List Fax Phone Numbers
      description: >-
        Fax lines available as the "From" number in the compose form.


        Fax-permissioned twin of the settings ``GET
        /admin/phone-numbers?type=FAX``

        endpoint. That one is gated by AI-assistant read, so a fax-only user
        403s

        there and the compose form wrongly renders "No fax line configured."


        Declared above ``GET /faxes/{fax_id}`` on purpose — same
        declaration-order

        hazard the ``unread-count`` route above documents, else ``{fax_id}``
        would

        swallow ``phone-numbers`` and 404.


        Returns a sparse ``PhoneNumberSummary`` (assistant/ring-group fields
        left at

        their schema defaults) so a fax-only role can't enumerate the tenant's

        voice/assistant topology through this endpoint.
      operationId: list_fax_phone_numbers_faxes_phone_numbers_get
      parameters:
        - name: TENANT
          in: header
          required: true
          schema:
            type: string
            title: Tenant
          description: The tenant you are making this request on behalf of
        - name: API-KEY
          in: header
          required: true
          schema:
            type: string
            title: Api-Key
          description: Your api key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/PhoneNumberSummary'
                type: array
                title: Response List Fax Phone Numbers Faxes Phone Numbers Get
components:
  schemas:
    PhoneNumberSummary:
      properties:
        id:
          type: string
          title: Id
        number:
          type: string
          title: Number
        isPrimary:
          type: boolean
          title: Isprimary
          default: false
        type:
          $ref: '#/components/schemas/PhoneNumberType'
          default: CALL
        timezone:
          type: string
          title: Timezone
          default: America/New_York
        locationId:
          anyOf:
            - type: string
            - type: 'null'
          title: Locationid
        ringGroupFailoverAssistantId:
          anyOf:
            - type: string
            - type: 'null'
          title: Ringgroupfailoverassistantid
        offHoursAssistantId:
          anyOf:
            - type: string
            - type: 'null'
          title: Offhoursassistantid
        keyterms:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Keyterms
        assistantCount:
          type: integer
          title: Assistantcount
          default: 0
        assistants:
          items:
            $ref: '#/components/schemas/PhoneNumberAssistantSummary'
          type: array
          title: Assistants
          default: []
        ringGroupCount:
          type: integer
          title: Ringgroupcount
          default: 0
        ringGroups:
          items:
            $ref: '#/components/schemas/PhoneNumberRingGroupSummary'
          type: array
          title: Ringgroups
          default: []
        createdDate:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Createddate
      type: object
      required:
        - id
        - number
      title: PhoneNumberSummary
    PhoneNumberType:
      type: string
      enum:
        - CALL
        - FAX
      title: PhoneNumberType
      description: >-
        Which SignalWire resource is bound to the DID's calling handler.


        SignalWire exposes one ``calling`` handler slot per DID, so a single
        number

        is either a voice line or a fax line — not both. SMS lives on a separate

        ``messaging`` handler and is bound in both cases.
    PhoneNumberAssistantSummary:
      properties:
        id:
          type: string
          title: Id
        firstName:
          type: string
          title: Firstname
      type: object
      required:
        - id
        - firstName
      title: PhoneNumberAssistantSummary
    PhoneNumberRingGroupSummary:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
      type: object
      required:
        - id
        - name
      title: PhoneNumberRingGroupSummary

````