Errors
Sometimes things don’t go according to plan. When a request fails, Antarctica will send back a standard HTTP error code so you can figure out what went wrong.
Here’s a breakdown of the common errors you might run into and how to sort them out.
Error Codes
| Code | Name | What’s usually wrong? |
|---|---|---|
400 | Validation Error | Something is missing or formatted wrong in your JSON. Check that you’re sending numbers where we expect numbers. |
401 | Auth Error | Your API Key is missing or invalid. Check that Authorization header. |
402 | Limit Reached | You might have hit your plan’s usage limit. Check your dashboard for billing info. |
403 | Forbidden | Your key is valid but doesn’t have the right permissions. Usually happens with read-only keys. |
404 | Missing Endpoint | Double-check your URL. Make sure you’re hitting /v1/telemetry/usage. |
429 | Rate Limit | You’re sending data a bit too fast. Back off for a second and try again. |
500 | Internal Error | Something went wrong on our end. If this sticks around, definitely let us know! |
What an error looks like
When we send an error back, we’ll try to give you a specific message in the response body so you know exactly what field caused the trouble.
{
"error": "Validation failed: \"request.modelId\" is required"
}If you keep running into issues, check out the Security page or the Setup Guide to make sure everything is configured correctly.