Dokumentace

REST API s OpenAPI popisem, MCP server pro AI agenty a webhooky pro hlídání změn. Vše pod jedním klíčem.

Autentizace

Klíč získáte registrací nebo POST /api/v1/auth/register. Posílejte ho v hlavičce Authorization: Bearer ap_live_… (nebo X-Api-Key). Odpovědi nesou X-Quota-Limit a X-Quota-Used; po vyčerpání měsíční kvóty přijde 429 quota_exceeded, při překročení limitu za minutu 429 rate_limited.

Firmy

GET /api/v1/companies/{country}/{ico}          country = CZ | SK; IČO bez nul na začátku funguje také
GET /api/v1/companies/search?q=&country=&limit=  název (překlepy, bez diakritiky) nebo prefix IČO

Odpověď obsahuje název, DIČ, právní formu, stav, sídlo (u CZ s kódem adresního místa RÚIAN), NACE, příznak plátce DPH a insolvence, přítomnost v registrech (registrations) a atribuci zdroje. Slovenské firmy mají historii názvů, adres a orgánů; české zatím jen aktuální stav a události.

Hlídání změn

POST   /api/v1/watchlists                         {"name","webhookUrl"?,"eventTypes"?[]}   → webhookSecret (jen jednou)
PUT    /api/v1/watchlists/{id}/items              [{"country","registrationNumber","externalRef"?,"tags"?[]}]  úplná synchronizace
POST   /api/v1/watchlists/{id}/items              přidat / upravit bez mazání
DELETE /api/v1/watchlists/{id}/items/{country}/{ico}
GET    /api/v1/events?after={eventId}&limit=      pull feed, stejný tvar jako webhook
GET    /api/v1/deliveries?status=                 log doručení webhooků

Typy událostí: entity_created</code>, <code class="inline">entity_dissolved</code>, <code class="inline">name_changed</code>, <code class="inline">address_changed</code>, <code class="inline">legal_form_changed</code>, <code class="inline">status_changed</code>, <code class="inline">statutory_body_changed</code>, <code class="inline">vat_registration_changed</code>, <code class="inline">vat_reliability_changed</code>, <code class="inline">insolvency_changed</code>, <code class="inline">registration_changed.

Webhook je POST s JSON tělem a hlavičkou X-ApiPoint-Signature: t=<unix>,v1=<hex>, kde v1 = HMAC-SHA256(secret, t + "." + body). Odpovězte 2xx do 15 s; jinak opakujeme po 1 min, 5 min, 30 min, 2 h, 6 h a 24 h. Události nemají garantované pořadí, deduplikujte podle id.

MCP server

URL https://apipoint.app/api/mcp (Streamable HTTP), hlavička Authorization: Bearer <klíč>. Nástroje company_lookup(country, registrationNumber) a company_search(query, country?, limit?). Volání se počítají do kvóty jako dotazy.

// Claude Code
claude mcp add --transport http apipoint https://apipoint.app/api/mcp --header "Authorization: Bearer ap_live_…"

OpenAPI a interaktivní reference

Strojový popis: /api/openapi/v1.json (import do Postmanu, generování SDK přes Kiota nebo openapi-generator).

Otevřít interaktivní referenci – vložte klíč vpravo nahoře do „Authentication“ a volejte endpointy přímo z prohlížeče.