When an outbound fax sent with the Sinch Fax API fails, the fax record tells you why. Most failures come from the call to the receiving number or from the exchange with the receiving fax machine.
Where do I find the error?
Open the fax under Fax > Faxes, or read errorType, errorCode and errorMessage in your callback. The full list is in Fax Error Messages.
If the API refused the request and you have no fax ID, see What do Sinch Fax API errors 401, 403, 422 and 503 mean?
What do the most common errors mean?
| Message | Possible suggestions |
|---|---|
| Busy | The line was in use. Try again later. |
| No answer from a fax machine / Ring Timeout | Confirm the number with the recipient and check that their fax machine is on. |
| No answer (The Receiving Machine May Be Out Of Paper) | Ask the recipient to check their machine. |
| No fax tone detected | No fax tone was heard on the call. Confirm with the recipient that this is a working fax number. |
| Phone number not operational / The destination phone number Is Not active | Confirm the number with the recipient. |
| Failed to train with any of the compatible modems | The fax machines could not agree how to start the fax, so no pages were sent. Try again later. If it keeps happening with the same number, ask the recipient to check their fax line. |
| The call dropped prematurely | The call ended before the fax finished. Try again. If it keeps happening to the same number, ask the recipient to check their line. |
| No response after sending a page / The remote fax machine hung up before receiving fax | The receiving machine stopped responding. Try again and ask the recipient to check their machine. |
| Far end cannot receive at the resolution of the image | Send again at a lower resolution. |
| Fax machine incompatibility / Far end is not compatible | Ask the recipient to check their fax settings, or send to a different fax number. |
| Any DOCUMENT_CONVERSION_ERROR | The problem is with the file, not the call. See Why did I get a Sinch Fax API document conversion error? |
Does Sinch retry failed faxes?
Yes, if retries are set. Set the number of retries (up to 5) and the delay between them on your fax service, or use maxRetries in your API request.
Faxes to one number keep failing
Send a test to a different fax number. If that fax completes, ask the recipient to check their line and machine.
When should I contact Support?
If faxes keep failing and you do not know why, contact Sinch Support with your Project ID and a few fax IDs, and we can help. You can also check the Sinch Status page for active incidents.
Comments
0 comments
Please sign in to leave a comment.