Регистрите на България — през едно API

Как работи

1. Регистрирайте се. Профилът за API е отделен от продукта за адвокати и е отворен за всеки. Ключът се издава от конзолата и се показва веднъж — пазете го като парола.
2. Подайте ключа във всяка заявка като заглавка X-Api-Key. Без ключ API-то отговаря 401 — данните не се четат анонимно.
3. Четете. Указателя на регистрите, търсене в един или във всички наведнъж, пълния текст на документ, делата по адвокат или по фирма.

curl -H "X-Api-Key: ВАШИЯТ_КЛЮЧ" "https://magistrat.bg/api/registries"
curl -H "X-Api-Key: ВАШИЯТ_КЛЮЧ" "https://magistrat.bg/api/kzk/documents?q=картел"
curl -H "X-Api-Key: ВАШИЯТ_КЛЮЧ" "https://magistrat.bg/api/search/unified?q=давност"
curl -H "X-Api-Key: ВАШИЯТ_КЛЮЧ" "https://magistrat.bg/api/tr/companies/121830616"

Какво има вътре

Пълният указател, с описание на всеки регистър, е на /registries, а машинно четимото му резюме — на /api/llms.txt.

Какво получавате с всяка заявка

• Търсене по думи и формите им — едно попадение на документ и откъсът със съвпадението; същото търсене като на сайта.
• Идентификатор към първоизточника във всеки запис, за да се провери на място.
• Лимитите в самия отговор — заглавки X-RateLimit-* и справка на потреблението в конзолата; превишението е 429, не грешни данни.
• Грешки с машинен код — стабилни кодове като not_found, invalid_api_key и rate_limited, никога само текст.

Регистрите във вашия AI асистент — MCP

Отделна страница за MCP: /mcp — същото, разказано за хората, които просто искат асистентът им да чете регистрите. Тук остава техническата справка.

Същите регистри могат да станат инструменти в асистента, който вече ползвате. Magistrat хоства MCP сървър (Model Context Protocol) на един адрес — посочвате го в клиента си и асистентът получава девет инструмента, без да пишете интеграционен код: списък на регистрите, търсене във всички наведнъж или в един по избор, пълния текст на документ, справка за дело по номер, делото със страните, заседанията и актовете му, текста на конкретен акт, фирмена справка по ЕИК и какво е ново по регистрите.

https://magistrat.bg/api/mcp

Свързването е конфигурация, не интеграция. За Claude Code:

claude mcp add --transport http magistrat https://magistrat.bg/api/mcp --header "X-Api-Key: mgst_ВАШИЯТ_КЛЮЧ"

За клиенти с mcp.json (Cursor и подобни):

{
  "mcpServers": {
    "magistrat": {
      "url": "https://magistrat.bg/api/mcp",
      "headers": { "X-Api-Key": "mgst_ВАШИЯТ_КЛЮЧ" }
    }
  }
}

Ключът е същият, който конзолата издава за API-то, и се подава като X-Api-Key; Authorization: Bearer mgst_… работи по същия начин за клиентите, които го предпочитат. И таксирането е същото: всяко извикване на инструмент е една заявка към лимитите на плана ви (безплатното ниво — 1 000 заявки месечно за организацията плюс минутните прозорци), а настройката на сесията струва още няколко заявки. Отделна MCP тарифа няма.

Достъп и цени

Ключът е задължителен за всяка заявка, а нивото му определя лимитите и за какво може да ползвате отговорите: безплатното е за оценка, платените — за продукция. Плащането е месечно или годишно, без ангажимент; отмяната спира следващото подновяване, не текущия период.

Пълно сравнение на плановете — лимитите един до друг, с годишните цени (10 месеца за 12). Месечната квота е за организацията — всички ключове заедно; минутните лимити са на ключ. Ключовете се издават и оттеглят от конзолата, а пълният указател на endpoint-ите е в документацията.

Границите, честно

• Текстът на съдебните актове е около 7%. Толкова публикува Единният портал за електронно правосъдие; където документ няма, отговорът го казва вместо да мълчи.
• Данните са такива, каквито източникът ги публикува. Не поправяме имена и не отгатваме липсващи полета — където има разминаване, то е в регистъра.
• Няма SLA на самообслужващите се нива. Гаранция за време и наличност се договаря — свържете се с нас.