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.
51 There was a problem in converting and merging files to the output file format. Contact Phaxio 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

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
35 Busy
36 Telephony error
37 Telephony error
39 Ring Timeout
43 Problem establishing connection
47 Phone number not operational
49 The Receiving Phone Number Is Not Operational
50 Call rejected
52 No route available
56 Telephony Error
58 Telephony error
59 Telephony error
61 Telephony error
62 Telephony Error
64 The call dropped prematurely
71 Incompatible destination
73 Number changed
74 Congestion
81 Telephony error
83 Telephony error
85 Call rejected
87 No answer from the fax machine
88 Network Error
89 The call dropped prematurely
90 Busy
91 Phone number not operational
92 Incompatible destination
93 The call dropped prematurely
94 No answer from the fax machine
95 Incompatible destination
96 The call dropped prematurely
97 Telephony error
98 Congestion
99 Telephony error
100 Problem with remote carrier
101 Congestion
102 Congestion
103 The call dropped prematurely
104 The call dropped prematurely
106 The call dropped prematurely
107 Phone number not operational
108 The call dropped prematurely
109 Phone number not operational
110 Network error
111 Congestion
112 No answer
114 The call dropped prematurely
115 The phone number has been changed
116 Phone number not operational
118 Busy
121 User requested simulated lineError
123 Phone number not operational
124 Congestion

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
33 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
42 Telephony error
44 Telephony Error
45 Fax machine incompatibility
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
65 Fax protocol error
66 Fax protocol error
67 Fax protocol error
68 Far end is not compatible
70 Fax protocol error
72 Fax protocol error
75 Manually canceled by user
76 Canceled automatically because timeout exceeded
77 Timed out waiting for receiver ready (ECM mode)
78 Telephony error
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

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 Phaxio 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 Phaxio 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.
105 Insufficient funds to send fax and not able to auto recharge.
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.