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

# Forward a fax

> Forward the documents from an existing fax job to another fax number.

Forward the documents associated with an existing fax job. Authenticate with a Bearer access token obtained from [Generate an access token](/api-reference/authentication/generate-access-token).

## Required information

Provide the existing fax `job_id` and the destination `fax_number`. Supply the destination in [E.164 format](/guides/data-formats#phone-numbers).

## Caller ID

Provide `caller_id` to select the sending number explicitly. When omitted, the account's default `fax_as` value is used.

The response returns a new `job_id` for the forwarded fax. If the source `job_id` cannot be found, the API returns `404 Not Found`.


## OpenAPI

````yaml POST /v1/faxes/forward
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/forward:
    post:
      tags:
        - Send Faxes
      summary: Forward a fax
      description: Forwards the documents from an existing fax job to another fax number.
      operationId: forwardFax
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ForwardFaxRequest'
            example:
              job_id: '12345'
              fax_number: '+12509997881'
      responses:
        '200':
          description: Fax processed for sending.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForwardFaxResponse'
              example:
                status: 1
                message: Fax processed for sending
                data:
                  job_id: 01M1NMGG0WY0THD0YA3ZWN9WY7
        '404':
          description: The source fax could not be found.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: integer
                  message:
                    type: string
              example:
                status: 0
                message: Fax Not Found
      security:
        - bearerAuth: []
components:
  schemas:
    ForwardFaxRequest:
      type: object
      additionalProperties: false
      required:
        - job_id
        - fax_number
      properties:
        job_id:
          type: string
          description: ID of the existing fax job whose documents will be forwarded.
          example: '12345'
        fax_number:
          type: string
          description: Destination fax number in E.164 format.
          pattern: ^\+[1-9][0-9]{1,14}$
          example: '+12509997881'
        caller_id:
          type: string
          description: >-
            Caller ID in E.164 format. When omitted, the account's default
            fax_as value is used.
          pattern: ^\+[1-9][0-9]{1,14}$
          example: '+12513120176'
    ForwardFaxResponse:
      type: object
      additionalProperties: false
      required:
        - status
        - message
        - data
      properties:
        status:
          type: integer
          const: 1
        message:
          type: string
          const: Fax processed for sending
        data:
          type: object
          additionalProperties: false
          required:
            - job_id
          properties:
            job_id:
              type: string
              description: ID of the new fax job created by the forward operation.
              example: 01M1NMGG0WY0THD0YA3ZWN9WY7
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````