Skip to main content
Specter returns all error responses as JSON so you can programmatically detect, log, and fix problems seamlessly.

Example

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY",
}
errorCode – machine‑readable identifier message – human‑friendly explanation with a potential fix‑it hint

Common HTTP status codes

CodeComment
400There was a problem with the request, it may be missing a field or a have a malformed field. This will not credit limit you, but will rate limit you.
401The request is unauthenticated, the API key was supplied, but it is not a valid key. In this case please check your key and try again, if it continues then contact support.
403Your API key is correct, but you do not have access to this endpoint. This may happen if your subscription plan does not allow you access to the endpoints. For instance if you are not signed up to the company API but try to access it.
404If the requested resource does not exist then this will be returned.
422If there was a problem with validation then this will be returned, the message field of the response will have information about how to fix this, if this does not help then please contact Specter support.
429Returned if the endpoint is either rate limited or credit limited
50xThere was an internal error, in this case we will not credit limit you, but we may have rate limited you
I