Errors

The API uses standard HTTP status codes and returns a consistent error body.

Error response shape

{
  "statusCode": 404,
  "error": "TENDER_NOT_FOUND",
  "message": "Tender with id 'abc' was not found"
}

Error codes use SCREAMING_SNAKE_CASE and are stable across versions.

Common status codes

Code	Meaning
400	Bad request — invalid parameters
401	Unauthorized — missing or expired token
403	Forbidden — insufficient permissions
404	Resource not found
422	Validation error
429	Too many requests — rate limit exceeded
500	Internal server error

Rate limiting

The API allows 300 requests per minute per account. When exceeded, the response is 429 Too Many Requests. Wait before retrying.