REST API Reference

All endpoints return JSON. Paid calls use the same Bearer token as MCP.

Authorization: Bearer czat_...

Endpoints

Endpoint	Description
GET https://ares.cz-agents.dev/v1/companies?q={query}	Search companies
GET https://ares.cz-agents.dev/v1/companies/{ico}	Company by IČO
GET https://ares.cz-agents.dev/v1/companies/{ico}/bank-accounts	Transparent bank accounts
GET https://ares.cz-agents.dev/v1/companies/{ico}/statutaries	Statutory body
GET https://sanctions.cz-agents.dev/v1/sanctions/check?ico={ico}	Screen IČO vs EU+OFAC
GET https://isir.cz-agents.dev/v1/insolvency/{ico}	Insolvency status
GET https://dd.cz-agents.dev/v1/dd/{ico}	Full DD report (basic free, full paid)
GET https://dd.cz-agents.dev/v1/dd/{ico}/risk	Risk score + top flags

Examples

Company Search

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" }
}

Company By 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" }
}

Bank Accounts

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

{
  "data": { "ico": "12345678", "accounts": [] },
  "meta": { "fetched_at": "2026-06-01T10:00:00.000Z", "source": "ares" }
}

Statutaries

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

{
  "data": { "ico": "12345678", "members": [{ "name": "Novák Consulting s.r.o.", "role": "member" }] },
  "meta": { "fetched_at": "2026-06-01T10:00:00.000Z", "source": "ares" }
}

Sanctions Check

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" }
}

Insolvency

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

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" }
}

DD Risk

curl https://dd.cz-agents.dev/v1/dd/12345678/risk

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

Response Envelope

{ "data": { ... }, "meta": { "fetched_at": "2026-06-01T10:00:00.000Z", "source": "dd" } }

Error Format

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