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

# API overview

> The public runtime API surface your backend calls

Your backend calls three endpoints with a project API key:

| Method | Path          | Purpose                                                  |
| ------ | ------------- | -------------------------------------------------------- |
| `POST` | `/v1/check`   | Check entitlement and affordability without mutation     |
| `POST` | `/v1/consume` | Authoritatively decide, deduct credits, and record usage |
| `POST` | `/v1/events`  | Record non-credit usage                                  |

Base URLs are deployment-specific. The dashboard's **Developers** page shows the configured runtime URL.

## Request conventions

* JSON request and response bodies
* Unexpected JSON fields are rejected
* `Authorization: Bearer <project API key>` on every request
* `X-Request-ID` is echoed when it contains 1–128 allowed ASCII characters; otherwise the runtime generates one
* Every response includes a request ID for support and log correlation
* Default request body limit: 64 KiB

Read [authentication](/api/authentication), then choose [check](/api/check), [consume](/api/consume), or [events](/api/events).