Error Messages
When your receive a callback from Phaxio notifying you of a failure,
it will contain two values that can help you understand what went wrong:
an error_code
and an error_type
.
The error_type
will give you a general idea of why the operation failed,
whereas the error_code
describes the issue in more detail. Below we list the error_codes
for the API,
segmented by their corresponding error_type
.
The 5 Phaxio error types:
Document Conversion Error
documentConversionErrors
usually occur when there is a problem with one of the files you posted.
id | message |
---|---|
4 | There was a problem in converting and merging files to the output file format. Contact support. |
54 | Could not access the url you provided. |
55 | The string_data URL you provided is invalid |
57 | There was a problem storing the file you provided. |
69 | There was a problem in converting and merging files to the output file format. |
122 | User simulated Document Conversion Error |
128 | Could not determine mimetype for file. |
129 | Mimetype not supported. |
130 | Mimetype not supported: application/xml |
133 | Failed to normalize PDF document |
Line Error
There was a problem with the phone line. The call could not be placed.
id | message |
---|---|
11 | The call dropped prematurely |
15 | Congestion |
16 | Ring Timeout |
17 | Busy |
19 | Immediate Hangup |
30 | No answer from the fax machine. |
32 | Incompatible destination |
34 | Phone number not operational |
43 | Problem establishing connection |
49 | The Receiving Phone Number Is Not Operational |
50 | Call rejected |
52 | No route available |
73 | Number changed |
87 | No answer from the fax machine |
88 | Network Error |
100 | Problem with remote carrier |
110 | Network error |
112 | No answer |
115 | The phone number has been changed |
121 | User requested simulated lineError |
Fax Error
A problem occured during the fax communication process.
id | message |
---|---|
6 | There was an error communicating with the far side. |
7 | Far end cannot receive at the size of image |
8 | No response after sending a page |
10 | Disconnected after permitted retries |
12 | Received no response to DCS or TCF |
13 | Timed out waiting for the first message |
14 | Timed out waiting for initial communication |
18 | Unexpected message received |
20 | The HDLC carrier did not stop in a timely manner |
21 | Received a DCN from remote after sending a page |
22 | Received bad response to DCS or training |
25 | Far end cannot receive at the resolution of the image |
26 | The remote fax machine failed to respond |
28 | Failed to train with any of the compatible modems |
29 | Invalid response after sending a page |
31 | Fax machine incompatibility |
38 | The remote fax machine hung up before receiving fax |
40 | Telephony error |
41 | Unexpected DCN while waiting for DCS or DIS |
44 | Telephony Error |
46 | Insufficient funds to send fax and not able to auto recharge: There was a problem charging your credit card. Please check your payment information and try again. |
48 | No answer (The Receiving Machine May Be Out Of Paper) |
53 | Unexpected DCN after EOM or MPS sequence |
60 | Transmission error after page break |
63 | Fax protocol error |
68 | Far end is not compatible |
75 | Manually canceled by user |
76 | Canceled automatically because timeout exceeded |
77 | Timed out waiting for receiver ready (ECM mode) |
79 | Can't cancel the fax, it's already complete! |
80 | Received a DCN while waiting for a DIS |
82 | There was an error communicating with the far side |
84 | Unexpected command after page received |
113 | The file for this fax has been deleted or is not accessible. |
117 | No pages received |
119 | User requested simulated faxError |
131 | Incomplete transmission |
132 | No fax tone detected |
Fatal Error
Something went wrong internally on our systems. This should occur very infrequently.
id | message |
---|---|
9 | Could not send the file to the fax server for spooling |
23 | There was a problem in the final stages of sending your fax. Contact support. |
24 | Error 500 - There was a problem in processing your request |
126 | User requested simulated fatalError |
General Error
Similar to fatalError but higher priority. As soon as one of these occurs, rest assured that we’re looking into it immediately and will follow up with what went wrong.
id | message |
---|---|
3 | General error. Contact support. |
5 | Insufficient funds to send fax and not able to auto recharge. |
86 | Insufficient funds to send fax and not able to auto recharge: Cannot autorecharge. There have been 4 or more failed billing attempts for this card. |
120 | User requested generalError |
125 | Insufficient funds to send fax and not able to auto recharge: Cannot autorecharge at this time. We've attempted to charge repeatedly in the past 2 hours. |