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

# API Reference

> Every Croma Legal endpoint, with an interactive playground.

Every endpoint in this reference lives under `https://api.legal.usecroma.com`
and is authenticated with a bearer API key. Pick an endpoint from the sidebar
to see its parameters, response schema, an example, and a "try it" playground.

## Endpoints

| Method | Path                                                                                       | What it returns                                       |
| ------ | ------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
| `GET`  | [`/v1/processes`](/legal/api-reference/list-processes)                                     | Your cases, filtered and cursor-paginated.            |
| `GET`  | [`/v1/processes/{process_id}`](/legal/api-reference/get-process)                           | One case, fully enriched. UUID or radicado.           |
| `GET`  | [`/v1/processes/{process_id}/actions`](/legal/api-reference/list-process-actions)          | A case's actuaciones, newest first.                   |
| `GET`  | [`/v1/actions`](/legal/api-reference/list-actions)                                         | The organization-wide actuaciones feed.               |
| `GET`  | [`/v1/defendants`](/legal/api-reference/list-defendants)                                   | Your defendants with case counts.                     |
| `GET`  | [`/v1/defendants/{defendant_id}/processes`](/legal/api-reference/list-defendant-processes) | Every case linked to one defendant.                   |
| `GET`  | [`/v1/analytics`](/legal/api-reference/get-analytics)                                      | KPIs and distributions over the portfolio.            |
| `POST` | [`/v1/exports`](/legal/api-reference/create-export)                                        | A CSV / JSONL export of the complete dataset (async). |
| `GET`  | [`/jobs/{id}`](/legal/api-reference/get-job)                                               | Status and result of an export job.                   |

## Conventions

* **Auth**: `Authorization: Bearer <key>` on every endpoint. See [Authentication](/legal/authentication).
* **Read endpoints are `GET`** with filters as query parameters; only exports are a `POST` with a JSON body.
* **Success**: responses wrap the payload under `data`: `{ "data": … }`. Lists add `next_cursor` and `has_more` (or `total`).
* **Errors**: `{ "error": { "type", "code", "message" } }` with a non-2xx status. See [Errors](/legal/errors).
* **No match**: an empty list is a `200`, not a `404`. Only the single-case endpoints return `404`, when the id or radicado isn't in your organization.
* **Field names** are `snake_case`; dates are ISO 8601 in UTC; ids are UUIDs, and processes also accept their radicado.
* **Rate limits**: reported via `X-RateLimit-*` response headers. See [Rate limits](/legal/rate-limits).
* **Scoping**: every response is limited to the organization that owns the key. There is no parameter to choose another organization.

<CardGroup cols={2}>
  <Card title="Pagination & filters" icon="list" href="/legal/pagination">
    Cursors, page sizes, date semantics and incremental sync.
  </Card>

  <Card title="Exports" icon="file-arrow-down" href="/legal/exports">
    Wait inline, poll, or get a callback for the complete dataset.
  </Card>
</CardGroup>