Magistrat API · MCP сървър

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

39 официални регистъра — съдебни дела и актове, закони и Държавен вестник, решения на регулаторите, Търговският регистър, обществени поръчки и публични продани — се четат програмно: JSON през HTTPS, ключ за минута, без договор за старта. Всеки отговор носи идентификатора, по който записът се проверява в първоизточника.

Първите 14 дни от Старт са безплатни: 250 заявки месечно за организацията, първото плащане е на 15-ия ден. Без план ключовете не отговарят.

Пример: търсене в един регистър
Заявка
curl -H "X-Api-Key: ВАШИЯТ_КЛЮЧ" \
  "https://magistrat.bg/api/kzk/documents?q=%D0%BA%D0%B0%D1%80%D1%82%D0%B5%D0%BB&pageSize=1"
Отговор · 200 · съкратен
{
  "registry": "kzk",
  "query": "картел",
  "total": 126,
  "hits": [
    {
      "id": "kzk-act:300049034/2/АКТ-318-28.03.2017",
      "title": "Решение № АКТ-318-28.03.2017",
      "date": "2017-03-28",
      "meta": "КЗК/98/2016 · решение · ЗЗК",
      "snippet": "… участието си в т.нар. картел …"
    }
  ],
  "hasMore": true
}
39официални регистъра
JSONедни и същи полета във всеки регистър
MCPсървър за AI асистенти, със същия ключ
250заявки месечно със Старт

Как работи

  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=%D0%BA%D0%B0%D1%80%D1%82%D0%B5%D0%BB"
curl -H "X-Api-Key: ВАШИЯТ_КЛЮЧ" "https://magistrat.bg/api/vks/documents?q=%D0%B4%D0%B0%D0%B2%D0%BD%D0%BE%D1%81%D1%82"
curl -H "X-Api-Key: ВАШИЯТ_КЛЮЧ" "https://magistrat.bg/api/tr/companies/121830616"

Думите в адреса са кодирани в UTF-8 (q=картел, q=давност) — така стигат еднакво от всеки терминал, и от Windows.

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

Съдебна практикадела и актове от всички съдилища, практиката на Върховния касационен и Върховния административен съд, актовете на Конституционния съд
Закони и обнародванияконсолидираните закони в сила, актовете на Народното събрание, Държавен вестник, правото на ЕС
Регулаторирешенията на регулаторите на конкуренцията, съобщенията, енергетиката и водите, финансовия надзор и личните данни, на Патентното ведомство и на Омбудсмана
Фирми и пазарТърговският регистър, обществените поръчки, публичните продани, несъстоятелността, туристическият регистър
Правни професииадвокати, нотариуси, частни съдебни изпълнители, съдебни заседатели
Един договор за всичкоедни и същи полета във всеки регистър: идентификатор, заглавие, дата, източник и пълен текст, където го има

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

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

Търсене по думи и формите им

Едно попадение на документ и откъсът със съвпадението — същото търсене като на сайта.

Идентификатор към първоизточника

Във всеки запис, за да се провери на място.

Лимитите в самия отговор

Заглавки X-RateLimit-* и справка на потреблението в конзолата; превишението е 429, не грешни данни.

Грешки с машинен код

Стабилни кодове като not_found, invalid_api_key, rate_limited — никога само текст. Всички кодове и какво да направите при всеки.

MCP сървър

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

Същият ключ отключва и MCP сървъра: шестнадесет инструмента върху регистрите в Claude Code, Cursor и други клиенти — без код, със същата квота.

Към MCP сървъра

Достъп

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

Старт
250заявки месечно със Старт
За оценка и вътрешна проба
  • 60 заявки в минута за записи, 120 за търсене
  • за оценка и нетърговска употреба
  • работа по дела на клиенти — със Стандартен или Бизнес
  • REST API и MCP сървър — един ключ, една квота
  • до 2 активни ключа
Създайте ключ — 14 дни безплатно
Платени нива
За продукция

Стандартен и Бизнес — до 25 000 заявки месечно и до десет пъти по-високи минутни лимити. Над това — по договор, без месечен таван.

За работата на кантора по дела — и през MCP в AI асистента — е нужен план Стандартен или по-висок.

Пълно сравнение на плановете

Месечната квота е за организацията — всички ключове заедно; минутните лимити са на ключ. Какво се брои и какво връща API-то при лимит — Как се броят заявките. Ключовете се издават и оттеглят от конзолата, а пълният указател на endpoint-ите е в документацията.

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

Текст има за около всеки пети съдебен акт.

За актовете от 2022 г. насам — за около всеки четвърти. Текстовете идват от Единния портал за електронно правосъдие и от портала за публикуване на съдебни актове; където текст няма, отговорът го казва, вместо да мълчи.

Данните са такива, каквито източникът ги публикува.

Не поправяме имена и не отгатваме липсващи полета — където има разминаване, то е в регистъра.

Без гаранция за наличност на самообслужващите се нива.

Време за отговор и наличност се договарят — свържете се с нас.

Готови?

Ключът се издава за минута и започва да отговаря, щом поръчате Старт: първите 14 дни са безплатни. За потоци, webhooks и договорени лимити — пишете ни.