API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Batch Processing
★  Specifications
★  Best Practice
★  SDKs
★  Stats
Data Tools
WWW
Telephony
Geolocation
Security and Networking
E-commerce
Imaging

API 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:

ParameterTypeDescription
api-errorintegerThe API error code. If set and > 0 then an API error has occurred and your request could not be completed
api-error-msgstringThe API error message detail

List of Error Codes

Neutrino API can return the following errors:

API Error CodeHTTP Status CodeError MessageDescription
01400MISSING OR INVALID PARAMETERYou are missing a required parameter or you supplied unparsable data for the parameter type
02400DAILY API LIMIT EXCEEDEDYou have exceeded the daily limit for this API on your current plan
03400INVALID URLThe API requires a valid URL or the URL supplied is not currently accessible
04400IP BANNEDYour IP address has been banned (only applies to free accounts)
05400NOT RESPONDING. RETRY IN [X] SECONDSYour requests are taking an unusual length of time to complete or are being received at a rate too fast to process
06400TOO MANY CONNECTIONSYou have exceeded the connection port limit for your account
07400ACCOUNT NOT VERIFIEDYou are trying to use an API that requires your account to be verified
08400TELEPHONY NOT ENABLEDYou can't use the telephony APIs on your current account type
10400ACCESS DENIEDThis API is not available on your account. Contact support for help
11400MAXIMUM SIMULTANEOUS PHONE CALLSThere are currently too many phone calls being placed. Wait for a minute and try again.
12400COULD NOT LOAD AUDIO DATA URLThe URL supplied does not contain valid (or compatible) audio data
13400HLR LIMIT REACHEDYou have exceeded the HLR overage for your account and your payment has declined
14400CALLS AND SMS TO THIS NUMBER ARE BLOCKEDYour telephony whitelist/blacklist has blocked calls/SMS to the supplied number
15400CALL IN PROGRESSA phone call is already in progress to this phone number
16400FREE PLAN LIMIT EXCEEDEDYou have exceeded the free plan limit for this API
17400RENDERING FAILEDPDF, PNG or JPG rendering has failed for your content or URL
21400BATCH PROCESSING NOT ENABLEDThis endpoint does not currently support batch processing
22400BATCH PROCESSING NOT AVAILABLEYour account plan does not support batch processing
23400BATCH PROCESSING LIMIT EXCEEDEDToo many items sent in a single batch requests
24400INVALID BATCH REQUESTYour batch request does not meet our minimum spec
43403ACCESS DENIEDYour user ID or API key is wrong or not supplied correctly
51500FATAL EXCEPTIONWe messed up, sorry! Your request has caused a fatal exception and can't continue