> ## 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.

# Research

> Ask an open question and get a cited Markdown report researched from live web sources, with numbered citations and the full list of sources behind it.

Ask an open question and get back a written report in Markdown with numbered
citations, plus the list of sources behind it. This is a research pass over
live sources, not a lookup against a registry: a call typically takes a few
seconds.

## Research a question

`POST /global/research/v1`

| Field | Type | Notes |
| - | - | - |
| `query` | string | **Required.** 10-2,000 chars. The question, in plain language. |

```bash theme={"dark"}
curl https://api.croma.run/global/research/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "¿Qué cambios trajo la Ley 2195 de 2022 en materia de responsabilidad de personas jurídicas en Colombia?" }'
```

| Field | Notes |
| - | - |
| `query` | Echoes the question asked. |
| `report` | The report in Markdown. Bracketed numbers such as `[1]` index into `sources`. |
| `sources` | The pages the report drew on, each with `title` and `url`. |
| `pages_analyzed` | How many sources the report drew on. |

<Note>
  A report is a starting point, not a citation. Verify anything you act on
  against the primary source — for Colombian case law and public records, the
  country guides return the record itself.
</Note>

<Warning>
  On the free plan, Research has the tightest quota on the API: **10 requests
  per hour** per organization, and each call also counts against your **100
  requests per day**. Paid plans have no hourly ceiling: each call spends 10
  credits from the plan. See [Rate limits](/rate-limits).
</Warning>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.