Документация

Программный доступ к DueDill: REST API и MCP-сервер для языковых моделей.

API-ключи

API-ключи создаются в кабинете, в разделе «API-ключи» (нужна учётная запись DueDill). Ключ (формат dd_...) используется для авторизации запросов к REST API.

Для MCP-сервера используется отдельная OAuth 2.1-авторизация — вход выполняется по логину и паролю DueDill непосредственно в процессе подключения.

REST API

Base URL

https://asmk-sdd.ru/api/v1

Авторизация

Заголовок Authorization: Bearer <ваш ключ dd_...> (или X-API-Key).

POST/api/v1/check

Проверка контрагента по ИНН (10 или 12 цифр). Тело запроса: {"inn":"7707083893"}. Необязательный параметр force_refresh принудительно обновляет кэш.

Возвращает: { inn, counterparty, verdict: { color, score, ... }, cached, report_id }

curl -X POST https://asmk-sdd.ru/api/v1/check \
  -H "Authorization: Bearer dd_..." \
  -H "Content-Type: application/json" \
  -d '{"inn":"7707083893"}'

GET/api/v1/report/{report_id}

Полный сохранённый отчёт по идентификатору: результат, секции рисков и ссылки на файлы.

curl https://asmk-sdd.ru/api/v1/report/REPORT_ID \
  -H "Authorization: Bearer dd_..."

GET/api/v1/search

Поиск контрагента по названию, ИНН или ОГРН. Бесплатно — не списывает проверки.

Параметры: q (строка, мин. 3 символа) · limit (1–50, по умолчанию 20) · page (смещение, по умолчанию 0).

Возвращает: { items:[{ name, inn, ogrn, kpp, state_code, state_name }], page, limit }

curl "https://asmk-sdd.ru/api/v1/search?q=ромашка&limit=10&page=0" \
  -H "Authorization: Bearer dd_..."

GET/api/v1/document

Скачать ВОК-PDF по ИНН. Параметры: inn (10 или 12 цифр) · type (dd, financial, business, excerpt; по умолчанию dd).

Биллинг: если ИНН не проверялся в текущем периоде — выполняется проверка с обычным списанием (квота/PAYG). Уже проверенный ИНН — бесплатно. Ответ — файл application/pdf.

curl "https://asmk-sdd.ru/api/v1/document?inn=7707083893&type=dd" \
  -H "Authorization: Bearer dd_..." \
  -o report.pdf

MCP-сервер (для Claude и других моделей)

URL сервера

https://asmk-sdd.ru/mcp

Авторизация — OAuth 2.1: вход по вашему логину DueDill выполняется при первом подключении.

Claude.ai (веб)

Настройки → Коннекторы → «Добавить пользовательский коннектор» → вставить https://asmk-sdd.ru/mcp → пройти OAuth-вход.

Claude Code (CLI)

claude mcp add --transport http duedill https://asmk-sdd.ru/mcp

Далее выполните /mcp в сессии для входа через браузер.

Messages API (Anthropic)

Бета-заголовок: anthropic-beta: mcp-client-2025-11-20

{
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://asmk-sdd.ru/mcp",
      "name": "duedill",
      "authorization_token": "<access-token>"
    }
  ],
  "tools": [
    {
      "type": "mcp_toolset",
      "mcp_server_name": "duedill"
    }
  ]
}

Инструменты MCP

Инструмент	Параметр	Что возвращает
search_counterparty	query	Поиск по ИНН — имя, ИНН, цвет вердикта
get_counterparty_report	inn	Полный отчёт: реквизиты, вердикт, секции рисков
check_risk_factors	inn	Сводка: банкротство, арбитраж, ФССП, индекс надёжности
get_financials	inn	Финансовые показатели
check_arbitration	inn	Арбитражные дела (количество и перечень)
find_counterparties	query	Поиск контрагентов по названию — список { name, inn, ogrn, kpp, state_name }. Бесплатно. Отличается от `search_counterparty`: тот принимает ИНН, этот — произвольный текст.
get_document_link	inn, type?	Возвращает ссылку на ВОК-PDF: { url, inn, type, note }. `type`: dd / financial / business / excerpt (по умолчанию dd). Сам файл скачивается по ссылке — MCP-инструмент байты не отдаёт. Биллинг аналогичен `/api/v1/document`: новый ИНН — списывается при скачивании.

Биллинг

Вызовы REST API и MCP тарифицируются как обычные проверки: считаются уникальные компании за календарный месяц. Повторный запрос того же ИНН в рамках месяца не тарифицируется.

Операция	Биллинг
Поиск (`/api/v1/search`, MCP `find_counterparties`)	Бесплатно
Полный отчёт / документ по новому ИНН (`/api/v1/check`, `/api/v1/document`, MCP-инструменты)	Тарифицируется как проверка (квота / PAYG)
Повторный запрос уже проверенного ИНН	Бесплатно