Limits
Limits are an essential part of ensuring that our API functions correctly. The following sections explain these limits and describe factors that affect API performance and capability.
A summary of limits is as follows.
| Info | Synchronous | Asynchronous |
|---|---|---|
| Communication | Request-response | Event driven |
| Latency | Low | Depends on size |
| Request limits | ≤ 25 peril-event combinations queries at a time | Depends on API Key limits |
Terminology
Synchronous call: A call made with an almost immediate response. Limited to a small number of peril-events of less than 25.
Asynchronous call: A call made which is added to a queue and will be processed and results returned when all processed. Ideal for larger queries.
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 401 | Missing or invalid API key. |
| 403 | API key not authorised for endpoint used. |
| 404 | Endpoint not found. |
| 405 | Method not allowed. A GET was used when should have been a POST or vica-versa |
| 422 | Missing required information in request |
| 429 | Rate limitation occured for your API Key |
| 500 | Internal Server Error |