Fundamentals
Multicloud / Geofence
API Examples
API Specification
SDKs / Codegen
Batch Processing
Best Practice
Error Codes
In the case of an API request failure a non-200 HTTP status code will be set.
The following specific error fields will also be set in the response body:
| Parameter | Type | Description |
|---|---|---|
| api-error | integer | The API error code. If set and > 0 then an API error has occurred and your request could not be completed |
| api-error-msg | string | The API error message detail |
Neutrino API can return the following error codes:
| Error Code | HTTP Status | Error Message |
|---|---|---|
| 1 | 400 | MISSING OR INVALID PARAMETER |
| 2 | 400 | DAILY API LIMIT EXCEEDED |
| 3 | 400 | INVALID URL |
| 4 | 400 | ACCOUNT OR IP BANNED |
| 5 | 400 | NOT RESPONDING. RETRY IN 5 SECONDS |
| 6 | 400 | TOO MANY CONNECTIONS |
| 7 | 400 | ACCOUNT NOT VERIFIED |
| 8 | 400 | TELEPHONY NOT ENABLED ON YOUR ACCOUNT. PLEASE CONTACT SUPPORT FOR HELP |
| 9 | 400 | INVALID JSON. JSON CONTENT TYPE SET BUT NON-PARSABLE JSON SUPPLIED |
| 10 | 400 | ACCESS DENIED. PLEASE CONTACT SUPPORT FOR ACCESS TO THIS API |
| 11 | 400 | MAXIMUM SIMULTANEOUS PHONE CALLS |
| 12 | 400 | COULD NOT LOAD AUDIO FROM URL |
| 13 | 400 | HLR LIMIT REACHED. CARD DECLINED |
| 14 | 400 | CALLS AND SMS TO THIS NUMBER ARE LIMITED |
| 15 | 400 | CALL IN PROGRESS |
| 16 | 400 | FREE PLAN LIMIT EXCEEDED |
| 17 | 400 | RENDERING FAILED. COULD NOT GENERATE OUTPUT FILE |
| 18 | 400 | THIS API IS DEPRECATED. PLEASE USE THE LATEST VERSION |
| 19 | 400 | MAXIMUM ACCOUNT CREDIT LIMIT REACHED. PAYMENT METHOD DECLINED |
| 21 | 400 | BATCH PROCESSING NOT ENABLED FOR THIS ENDPOINT |
| 22 | 400 | BATCH PROCESSING NOT AVAILABLE ON YOUR PLAN |
| 23 | 400 | BATCH PROCESSING REQUEST LIMIT EXCEEDED |
| 24 | 400 | INVALID BATCH REQUEST. DOES NOT CONFORM TO SPEC |
| 31 | 400 | DAILY API LIMIT EXCEEDED. SET BY ACCOUNT HOLDER |
| 43 | 403 | ACCESS DENIED. USER ID OR API KEY INVALID |
| 44 | 400 | REQUEST TOO LARGE. MAXIMUM SIZE IS 5MB FOR DATA AND 25MB FOR UPLOADS |
| 45 | 400 | ENDPOINT DOES NOT EXIST |
| 51 | 500 | FATAL EXCEPTION. REQUEST COULD NOT BE COMPLETED |
| 52 | 500 | SERVER OFFLINE. MAINTENANCE IN PROGRESS |
Neutrino API SDKs can return the following error codes:
| Error Code | Error Message |
|---|---|
| 61 | TIMEOUT OCCURRED CONNECTING TO SERVER |
| 62 | TIMEOUT OCCURRED READING API RESPONSE |
| 63 | TIMEOUT OCCURRED DURING API REQUEST |
| 64 | ERROR RECEIVED FROM YOUR DNS RESOLVER |
| 65 | ERROR DURING TLS PROTOCOL HANDSHAKE |
| 66 | ERROR PARSING REQUEST URL |
| 67 | IO ERROR DURING API REQUEST |
| 68 | IO ERROR WRITING TO OUTPUT FILE |
| 69 | INVALID JSON DATA RECEIVED |
| 70 | NO PAYLOAD DATA RECEIVED |
| 71 | API GATEWAY ERROR |