API территориальной подсудности

Определение районного/городского суда и участка мирового судьи по адресу или координатам. Возвращает данные суда и контакты.

Аутентификация

Каждый запрос требует параметр token. Токен — у каждого пользователя свой, выдаётся при регистрации, доступен в личном кабинете.

Безопасность: токен — серверный секрет. Не используйте его в клиентском JS, отправляйте запросы со своего сервера.

Эндпоинты

GET
https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?token=&address=
Поиск судов по текстовому адресу
GET
https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?token=&coords=lat lng
Поиск судов по координатам
GET
https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/account?token=
Информация об аккаунте, балансе, тарифе

Также поддерживается legacy URL https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/api/... — для обратной совместимости. Новые интеграции — на /v1/.

Параметры

ПараметрТипОбязательныйОписание
tokenstringдаТокен из личного кабинета
addressstringодин изАдрес одной строкой. Город, улица, дом. Пример: «Москва, Тверская, 1»
coordsstringодин изКоординаты «широта долгота» через пробел. Пример: «55.755826 37.6173»

Параметры address и coords взаимоисключающие. Передайте один из двух.

Внимание! Адрес следует отправлять с точностью до здания в формате: Город, улица, дом (здание / строение / корп), без указания кв., пом., этажа и других более конкретных данных. Указание лишних данных может привести к неточности определения подсудности.

Примеры запросов

curl "https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?token=YOUR_TOKEN&address=Москва,+Тверская,+1"

Попробовать

Отправит реальный GET-запрос к api с указанным токеном и адресом. Учитывается в дневном лимите.

Примеры ответов

Успех

{
  "data": {
    "last": 987.5,
    "status": 1
  },
  "request": {
    "address": "Москва, Тверская, 1",
    "coords": null,
    "court_fs": {
      "code": "77RS0023",
      "title": "Савеловский районный суд (Город Москва)",
      "address": "125047, г. Москва, ул. Бутырский вал, д. 7, стр. 1",
      "site": "https://mos-gorsud.ru/rs/savyolovskij http://savelovsky.msk.sudrf.ru",
      "email": "info@23.msksud.ru savelovsky.msk@sudrf.ru",
      "tel": "(499) 250-40-31"
    },
    "court_ms": {
      "code": "77MS0370",
      "title": "Судебный участок № 370 Тверского района",
      "address": "109012, г. Москва, Новая площадь, д. 8, стр. 1",
      "site": "http://mos-sud.ru/ms/370"
    }
  }
}
  • data.status: 1 — успех. 0 — ошибка.
  • data.last — остаток запросов на день (free) / руб. до исчерпания (balance).
  • court_fs — районный/городской суд. court_ms — участок мирового судьи.
  • Поля email, tel могут отсутствовать — если данных в базе нет.
  • site, email могут содержать несколько значений через пробел.
  • Если суд для адреса не найден в базе — соответствующее поле = null.

Ошибка

{
  "data": {
    "status": 0,
    "error": "Дневной лимит запросов исчерпан"
  }
}

HTTP-статус всегда 200. Признак ошибки — data.status === 0. Текст в data.error.

Ошибки

Все возможные тексты data.error и что делать клиенту:

data.errorЧто значитДействие
Токен не переданВ запросе нет параметра tokenДобавить параметр
Токен недействителенТокен не существует или отозванПроверить, при необходимости перевыпустить в /account
Доступ к API заблокированАккаунт заблокирован администраторомСвязаться с поддержкой
Недопустимый тип тарифаВнутренняя ошибка состояния тарифаСвязаться с поддержкой
Не передан адрес или координатыНет ни address, ни coordsПередать один из параметров
Координаты должны быть в формате "долгота широта" (через пробел)Неверный формат coordsПример: 37.6173 55.755826
Дневной лимит запросов исчерпанУ free-тарифа дневной лимит исчерпан, у balance — недостаточно средствПодождать до следующих суток (free) или пополнить баланс (balance)
Не удалось получить данные геокодераВременные проблемы со внешним геокодеромПовторить позже
Не удалось распознать адрес. Проверьте корректность написания.Геокодер не нашёл координат для адресаУточнить адрес: город, улица, дом
Суды для указанного адреса не найдены в базе. Возможно, они ещё не добавленыАдрес распознан, но в базе нет покрытия по этому регионуСвязаться с поддержкой если регион должен быть в базе
Внутренняя ошибка сервераСерверная ошибкаПовторить через минуту, при повторе — поддержка

Лимиты и тарифы

Free

50 запросов в сутки. Бесплатно. Лимит обновляется в полночь по Москве.

data.last — остаток запросов на сегодня.

Balance

Оплата с баланса. Стоимость одного запроса — 1 руб. Баланс пополняется в личном кабинете.

data.last — остаток средств на балансе (руб.) до исчерпания.

Сменить тариф и пополнить баланс можно в личном кабинете. Лимиты меняются мгновенно.

OpenAPI

OpenAPI-спецификация описывает api в стандартном формате. Импортируется в Postman, Insomnia, Swagger UI одной кнопкой — сразу получите интерактивные доки и автогенератор клиентов.

Скачать openapi.json