Skip to main content
POST
Forward a fax
Forward the documents associated with an existing fax job. Authenticate with a Bearer access token obtained from Generate an access token.

Required information

Provide the existing fax job_id and the destination fax_number. Supply the destination in E.164 format.

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.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
job_id
string
required

ID of the existing fax job whose documents will be forwarded.

Example:

"12345"

fax_number
string
required

Destination fax number in E.164 format.

Pattern: ^\+[1-9][0-9]{1,14}$
Example:

"+12509997881"

caller_id
string

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"

Response

Fax processed for sending.

status
integer
required
message
string
required
Allowed value: "Fax processed for sending"
data
object
required