200 | Success | Parse the response. |
400 | Bad parameters | Server API only. A malformed value, for example a non-UUID where a UUID is required. The body is a bare JSON string. Fix the request. |
401 | Bad credentials or disabled domain | The body is empty. Check your Server API credentials (Authorization: Bearer — see Keys) or ?publicKey= (snippet), and that the domain is enabled. |
402 | Out of requests | The body is empty. Your balance is exhausted. The Management API History path bills 1 request per returned row (a 0-row lookup still bills 1); account History reads on account.shieldlabs.ai are free. Top up your billing balance. |
404 | Unsupported history type | Server API only. The history type is not supported. The body is a bare JSON string. type must be one of ip, user_hid, visitor_id, request_id, device_id. A supported type that matches no records returns 200 with [] (and still bills 1 request), not 404. |
429 | Rate-limited | REST ingest and network-check gateways only, not the Server API. The body is { "error": "..." }. You hit an infrastructure rate limit. Back off and retry. |
500 | Internal error | Transient. Retry with backoff. |
503 | Server busy | REST ingest and network-check gateways only, not the Server API. The body is { "error": "..." }. A concurrency cap was hit. Retry with backoff. |
