Errors

Sometimes things don’t go as planned! When an API request fails, Antarctica.io will return an error code so that your app knows what went wrong.

Here is a list of the exact HTTP error codes we use, what they mean, and how you can fix them.

Code	Meaning	How to fix
`400`	Validation Error	You forgot to send a required field (like `tokens`), or you sent a string when we expected a number. Check your data!
`401`	Authentication Error	Your API Key is missing or incorrect. Make sure you pasted it correctly in the `Authorization` header.
`402`	Paywall Error	Your account limit is over or payment is required. Log into the Dashboard to upgrade.
`403`	Forbidden Error	Your API key is valid, but it doesn’t have permission to do this action.
`404`	Not Found Error	You hit a URL that doesn’t exist. Make sure you are sending data to `/v1/telemetry/usage`.
`429`	Rate Limit Error	Whoa there! You are sending data too fast. Wait a moment and try again.
`500`	Internal Server Error	This means we broke something, or the database is down. Let us know!

Example of an Error Response

If you get an error, the body of the response will give you a helpful message.

{
  "error": "Validation failed: \"request.modelId\" is required"
}