Регистрите на България — през едно 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"{
"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
}Как работи
- Регистрирайте се
Регистрацията е отворена за всеки, а който вече ползва асистента, добавя API-то към същия профил. Ключът се издава от конзолата и се показва веднъж — пазете го като парола.
- Подайте ключа
във всяка заявка като заглавка
X-Api-Key. Без ключ API-то отговаря 401 — данните не се четат анонимно. - Четете
Указателя на регистрите, търсене във всеки регистър, пълния текст на документ, делата по адвокат или по фирма.
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 — никога само текст. Всички кодове и какво да направите при всеки.
Регистрите и във вашия AI асистент
Същият ключ отключва и MCP сървъра: шестнадесет инструмента върху регистрите в Claude Code, Cursor и други клиенти — без код, със същата квота.
Достъп
Ключът е задължителен за всяка заявка, а планът му определя лимитите и за какво може да ползвате отговорите: Старт е за оценка и нетърговска употреба, Стандартен и Бизнес — за продукция. MCP сървърът е включен във всеки план, със същия ключ и същата квота.
- 60 заявки в минута за записи, 120 за търсене
- за оценка и нетърговска употреба
- работа по дела на клиенти — със Стандартен или Бизнес
- REST API и MCP сървър — един ключ, една квота
- до 2 активни ключа
Стандартен и Бизнес — до 25 000 заявки месечно и до десет пъти по-високи минутни лимити. Над това — по договор, без месечен таван.
За работата на кантора по дела — и през MCP в AI асистента — е нужен план Стандартен или по-висок.
Пълно сравнение на плановетеМесечната квота е за организацията — всички ключове заедно; минутните лимити са на ключ. Какво се брои и какво връща API-то при лимит — Как се броят заявките. Ключовете се издават и оттеглят от конзолата, а пълният указател на endpoint-ите е в документацията.
Границите, честно
За актовете от 2022 г. насам — за около всеки четвърти. Текстовете идват от Единния портал за електронно правосъдие и от портала за публикуване на съдебни актове; където текст няма, отговорът го казва, вместо да мълчи.
Не поправяме имена и не отгатваме липсващи полета — където има разминаване, то е в регистъра.
Време за отговор и наличност се договарят — свържете се с нас.
Готови?
Ключът се издава за минута и започва да отговаря, щом поръчате Старт: първите 14 дни са безплатни. За потоци, webhooks и договорени лимити — пишете ни.