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

# Get fax status

> Retrieve the current transmission status and delivery details for a fax job.

Use the `job_id` returned by [Send a fax](/api-reference/fax/post-fax-send) or [Forward a fax](/api-reference/fax/post-fax-forward) to retrieve the latest state of that fax. `job_id` is required.

The response includes the current status, sending and destination numbers, page counts, call timing, and any status message or code reported by the fax service.


## OpenAPI

````yaml POST /v1/faxes/status
openapi: 3.1.0
info:
  title: Amplify Customer API
  version: 1.0.0
  description: |-
    Canonical contract for the Amplify customer-facing API. This YAML file is
    the source of truth for Postman and Mintlify. Operations marked with
    x-amplify-validation-status: pending were migrated from the legacy Postman
    collection and must be validated before their contract is considered final.
servers:
  - url: https://api.amplify.xyz
    description: Production
  - url: https://dev-api.amplify.xyz
    description: Development
security: []
tags:
  - name: Authentication
  - name: Fax
  - name: Send Faxes
  - name: Receive Faxes
  - name: Manage Faxes
  - name: Workspace
  - name: Numbers
  - name: Contacts
  - name: Documents
  - name: Templates
paths:
  /v1/faxes/status:
    post:
      tags:
        - Send Faxes
      summary: Get fax status
      description: >-
        Returns the current transmission status and delivery details for the fax
        identified by job_id.
      operationId: postv1FaxesStatus
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - job_id
              properties:
                job_id:
                  type: string
                  description: Unique identifier returned when the fax was submitted.
                  example: 01M1NSAPE73ZJTEGEZQMHC8P6P
            example:
              job_id: 01M1NSAPE73ZJTEGEZQMHC8P6P
      responses:
        '200':
          description: Current fax status returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FaxStatusResponse'
              example:
                status: 1
                message: Fax status response.
                data:
                  job_id: 01M1NSAPE73ZJTEGEZQMHC8P6P
                  from_number: '+19073131400'
                  to_number: '+14084132233'
                  fax_call_length: 0
                  fax_call_start: 1788511347
                  fax_call_end: null
                  fax_total_pages: 1
                  fax_transferred_pages: 1
                  fax_status: Sending
                  message: ''
                  code: 0
        '404':
          description: No fax record was found for the supplied job_id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FaxRecordNotFoundResponse'
              example:
                status: 0
                message: No record found
      security:
        - bearerAuth: []
components:
  schemas:
    FaxStatusResponse:
      type: object
      required:
        - status
        - message
        - data
      properties:
        status:
          type: integer
          const: 1
        message:
          type: string
          const: Fax status response.
        data:
          type: object
          required:
            - job_id
            - from_number
            - to_number
            - fax_call_length
            - fax_call_start
            - fax_call_end
            - fax_total_pages
            - fax_transferred_pages
            - fax_status
            - message
            - code
          properties:
            job_id:
              type: string
              description: Unique identifier for the fax job.
            from_number:
              type: string
              description: Sending fax number in E.164 format.
              pattern: ^\+[1-9][0-9]{1,14}$
            to_number:
              type: string
              description: Destination fax number in E.164 format.
              pattern: ^\+[1-9][0-9]{1,14}$
            fax_call_length:
              type: integer
              description: Current call duration in seconds.
            fax_call_start:
              type: integer
              description: Transmission start time represented as a Unix timestamp.
            fax_call_end:
              type:
                - integer
                - 'null'
              description: >-
                Transmission end time represented as a Unix timestamp, or null
                while the fax is in progress.
            fax_total_pages:
              type: integer
              description: Total number of pages in the fax.
            fax_transferred_pages:
              type: integer
              description: Number of pages transferred so far.
            fax_status:
              type: string
              description: Current transmission status.
            message:
              type: string
              description: Status detail supplied by the fax service.
            code:
              type: integer
              description: Status code supplied by the fax service.
    FaxRecordNotFoundResponse:
      type: object
      additionalProperties: false
      required:
        - status
        - message
      properties:
        status:
          type: integer
          const: 0
        message:
          type: string
          const: No record found
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````