> ## Documentation Index
> Fetch the complete documentation index at: https://docs.risk.matrisk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> API Reference

The Matrisk API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

### Telematics Note:

Telematics devices generate large volumes of data, which can make real-time processing impractical. As a result, APIs involving telematics data are designed to operate asynchronously. Rather than performing calculations immediately, you queue a job and periodically check its status to retrieve the results once available.

Responses will typically take **between 5 seconds to a couple of minutes** to complete.

### Rate Limits:

API usage is subject to rate limits applied on a requests per minute (RPM) basis.

| **Endpoint Group**        | **Operation**                | **Rate Limit** |
| ------------------------- | ---------------------------- | -------------- |
| **Garaging (CA & PPA)**   | Calculate Risk Score         | 250 RPM        |
| **Telematics (CA & PPA)** | Queue Risk Score Calculation | 50 RPM         |
| **Aggregated Crashes**    | Get Aggregated Crash Data    | 250 RPM        |

Have a question? [Don't hesitate to reach out](mailto:sergey@matrisk.ai).