API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Batch Processing
★  Specification
★  SDKs
★  Stats
Data Tools
★  Browser Bot
★  HTML Clean
★  Code Highlight
★  URL Info
Security and Networking

API Error Codes

Neutrino API can return the follow types of errors:

HTTP Status Codes

The API can return the following HTTP status codes:

HTTP Status CodeReason
200 (OK)Your API request has been accepted
400 (Bad Request)Your API request has been rejected. Check the error codes below for specific error details
403 (Forbidden)You have failed to authenticate or are using an invalid API path
500 (Internal Server Error)We messed up, sorry! Your request has caused a fatal exception

Specific API Errors

The API can return the following error fields:

api-errorintegerAPI error code. If set and > 0 then an API error has occurred your request could not be completed
api-error-msgstringAPI error message

API Error Codes

Error CodeError MessageReason
1MISSING OR INVALID PARAMETERYou are missing a required parameter or you supplied unparsable data for the parameter type
2DAILY API LIMIT EXCEEDEDYou have exceeded the daily limit for this API on your current plan
3INVALID URLThe API requires a valid URL or the URL supplied is not currently accessible
4IP BANNEDYour IP has beeb banned (only applies to free accounts)
5NOT RESPONDING. RETRY IN [X] SECONDSThere is a problem with the underlying API system or your requests are taking an unusual length of time to complete. This is usually a transient error so you can retry your request again if needed
6TOO MANY CONNECTIONSYou have exceeded the connection port limit for your account
7ACCOUNT NOT VERIFIEDYou are trying to use an API that requires your account to be verified
8TELEPHONY NOT ENABLED ON YOUR ACCOUNTYou can't use the telephony APIs on your current account type
9TRANSACTIONAL LIMIT REACHED. RETRY IN [X] SECONDSYou have exceeded the transactional limit for this API. This only applies to APIs which have transactional limits
10ACCESS DENIEDThis API is not available to your account. Contact support for help
11MAXIMUM SIMULTANEOUS PHONE CALLSThere are currently too many phone calls being placed. Wait for a minute and try again.
12COULD NOT LOAD AUDIO DATA URLThe URL supplied does not contain valid (or compatible) audio data
13HLR LIMIT REACHEDYou have exceeded the HLR overage for your account and your payment has declined
14CALLS AND SMS TO THIS NUMBER ARE BLOCKEDYour telephony whitelist/blacklist has blocked calls/SMS to the supplied number
15CALL IN PROGRESSA phone call is already in progress to this phone number
17RENDERING FAILEDPDF, PNG or JPG rendering has failed for your content or URL