For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dropbox Sign WebSDKsSign Up
DocumentationAPIChangelog
DocumentationAPIChangelog
  • API Quickstart
  • API Reference
    • Welcome
    • Authentication
    • Account
    • Signature Request
    • Template
    • Bulk Send Job
    • Report
    • Team
    • Unclaimed Draft
    • Embedded
    • API App
    • Fax
      • GETGet Fax
      • GETLists Faxes
      • GETDownload Fax Files
      • POSTSend Fax
      • DELDelete Fax
    • Fax Line
  • Manual Reference Pages
    • Warnings and Errors
    • Constants
    • Search
    • Premium Branding
    • Expiration
    • Glossary
LogoLogo
Dropbox Sign WebSDKsSign Up
On this page
  • Fax Endpoints
  • Fax Status
  • Fax Status Codes
  • Fax Error Codes
API Reference

Fax

||View as Markdown|
Was this page helpful?
Previous

Delete API App

Next

Get Fax

Built with

Fax endpoints are used to send new faxes, as well as to retrieve information or delete previously sent faxes.

The Fax object returned by these endpoints can be used to reference request-specific data including the recipient phone number or email address, cover page message, and timestamps for when the fax was sent.

To sign up and send faxes, contact support to upgrade to the Fax API plan: Submit a Ticket

Fax Endpoints

SummaryEndpointDescription
Get Fax/fax/{fax_id}Return the Fax specified by the fax_id parameter.
List Faxes/fax/listReturn a list of Faxes that you can access.
Download Files/fax/files/{fax_id}Obtain a copy of the current documents specified by the fax_id parameter.
Send Fax/fax/sendCreate and send a new fax with the submitted documents.
Delete Fax/fax/{fax_id}Delete the fax specified by the fax_id parameter.

Fax Status

Making a request to the Send Fax starts the sending process. Receiving a 200 HTTP response does not guarantee the fax was sent successfully for a number of reasons (i.e. a file conversion error or busy signal). Once the status_code updates, you’ll receive a POST to the callback URL you provided.

Fax Status Codes

List and details of possible Fax status codes that can be returned:

StatusDescription
transmittingTransmitting/sending
successSuccessfully sent
on_holdOn hold - account is unconfirmed

Fax Error Codes

List and details of possible Fax errors that can be returned:

ErrorDescription
error_busyBusy signal
error_no_answerNo answer
error_could_not_faxUnable to fax (usually due to a bad connection)
error_disconnectedLine disconnected or unreachable
error_bad_destinationThe line is has been banned (should not happen for US numbers)
error_unknownUnknown error (usually occurs if someone picks up the line or an error occurred during transmission)
error_fileError processing the provided file