Docs
العربية Get your keys

Errors and limits

What the API answers when a request fails, and how much it accepts.

On this page

Error format#

Every error has the same body. message is always a list.

401 Unauthorized
{
  "success": false,
  "statusCode": 401,
  "message": ["Invalid API key"],
  "errors": null,
  "timestamp": "2026-10-30T10:03:06.493Z"
}

Status codes#

StatusMeaningWhat to do
400A field has the wrong type, id is not valid, or an outcome has neither verdict nor outcome.Fix the request.
401The secret key is missing or wrong.Check X-API-Key.
404Antiro does not know this order or check, or an outcome names neither order_id nor assessment_id.Check the id.
429Too many requests.Accept the order, and check it again shortly.
5xxAntiro could not answer.Accept the order, and check it again later.

Never lose an order to an error: see If no answer arrives.

Rate limits#

RequestLimit
POST /v1/assessments600 a minute for each store
POST /v1/outcomes6,000 a minute for each key
GET /v1/assessments/:id600 a minute for each key

A 429 can also appear when too many checks run at the same moment. It is always temporary. If you need a higher limit, contact us.

Field limits#

Text longer than its limit is cut to that size, not refused.

FieldMaximum characters
session_token1,024
order_id128
phone64
ip64
name500
address3,000
wilaya, commune300

Search by topic, field name or status code.