Research - Croma API

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.

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.

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.

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.

Full reference

Schemas, all response fields, and an interactive playground.