Skip to main content

Babel Street Analytics API

Error Codes

Standard HTTP response codes are used to indicate the success or failure of an API request. 400 codes indicate a problem with the call, while 500 indicates a problem with the server.

HTTP Code	Error Code	Meaning
400	`invalidParameter`	The provided parameter is unsupported or of the wrong type.
400	`badRequestFormat`	The data sent cannot be parsed; the format of the request is invalid.
400	`unsupportedLanguage`	The data is in a language which is not supported by the endpoint.
400	`noMatch`	The language code provided is not supported by the endpoint.
400	`notEnoughData`	There was insufficient data for the endpoint to produce meaningful results.
400	`badInput`	There is a problem with the input data.
400	`nonWorkingURL`	There is a problem downloading content from the provided URL; it is either invalid, non-existent, inaccesible, or having other problems.
400	`unsupportedContentType`	The text extractor doesn’t support the raw data’s content type.
401	`unauthorized`	You have not specified an API key.
403	`forbidden`	Access denied. You have either provided an invalid API key or are not authorized to call the endpoint.
404	`notFound`	The specified URI could not be found.
406	`notAcceptable`	You requested a format that isn’t JSON.
409	`incompatibleClientVersion`	Your binding is out of date. Please update to the latest version.
413	`tooMuchData`	Too much data to process in a single request. Your payload was bigger than the size limit of 600KB, or 50K characters.
429	`tooManyRequests`	Too many requests - Slow down! Only one call can be processed at a time.
429	`overPlanLimit`	You have exceeded your daily or monthly call limit.
500	`internalServerError`	There was a problem with the server. Please try again later.
503		Service Unavailable - We’re temporarily offline for maintenance. Please try again later.