REST API reference

Všechny endpointy vrací JSON. Placená volání používají stejný Bearer token jako MCP.

Authorization: Bearer czat_...

Endpointy

Příklady

Vyhledávání firem

curl "https://ares.cz-agents.dev/v1/companies?q=Acme"

{
  "data": { "items": [{ "ico": "12345678", "name": "Acme Imports s.r.o." }] },
  "meta": { "fetched_at": "2026-06-01T10:00:00.000Z", "source": "ares" }
}

Detail firmy podle IČO

curl https://ares.cz-agents.dev/v1/companies/12345678

{
  "data": { "ico": "12345678", "name": "Acme Imports s.r.o.", "status": "active" },
  "meta": { "fetched_at": "2026-06-01T10:00:00.000Z", "source": "ares" }
}

Sankční kontrola

curl "https://sanctions.cz-agents.dev/v1/sanctions/check?ico=12345678"

{
  "data": { "ico": "12345678", "name": "Acme Imports s.r.o.", "matches": [] },
  "meta": { "fetched_at": "2026-06-01T10:00:00.000Z", "source": "sanctions" }
}

Insolvence

curl https://isir.cz-agents.dev/v1/insolvency/12345678

{
  "data": { "ico": "12345678", "name": "Novák Consulting s.r.o.", "active": false, "cases": [] },
  "meta": { "fetched_at": "2026-06-01T10:00:00.000Z", "source": "isir" }
}

DD report (placený)

curl -H "Authorization: Bearer czat_..." https://dd.cz-agents.dev/v1/dd/12345678

{
  "data": { "ico": "12345678", "company": { "name": "Acme Imports s.r.o." }, "risk_score": { "value": 18, "level": "low" }, "red_flags": [] },
  "meta": { "fetched_at": "2026-06-01T10:00:00.000Z", "source": "dd" }
}

Obálka odpovědi

{ "data": { ... }, "meta": { "fetched_at": "...", "source": "ares" } }

Formát chyby

{
  "type": "https://cz-agents.dev/problems/not_found",
  "title": "not_found",
  "status": 404,
  "detail": "..."
}