Юридические данные

Получение юридических данных организации

Возвращает юридические данные организации. Требует доступ org.legal.read.

Запрос

Метод: GET URL: https://b2b.selfwork.ru/openapi/v2/organisation/{organisationId}/legal

Path Parameters

Параметр	Тип	Обязательное поле	Пример	Описание
organisationId	string (uuid)	Да	550e8400-e29b-41d4-a716-446655440000	ID организации

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

curl -X 'GET' \
  "https://b2b.selfwork.ru/openapi/v2/organisation/550e8400-e29b-41d4-a716-446655440000/legal" \
  -H "accept: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

Пример успешного ответа

{
  "requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
  "result": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "organisationId": "550e8400-e29b-41d4-a716-446655440001",
    "version": 1,
    "legalForm": "ООО",
    "shortLegalName": "ООО Рога и Копыта",
    "fullLegalName": "Общество с ограниченной ответственностью «Рога и Копыта»",
    "inn": "7707083893",
    "ogrn": "1027700132195",
    "kpp": "770701001",
    "city": "Москва",
    "representativeFullName": "Иванов Иван Иванович",
    "representativePosition": "Генеральный директор",
    "representativeAuthority": "Устав",
    "address": "г. Москва, ул. Пушкина, д. 1",
    "comment": "Основное юридическое лицо",
    "createdAt": "2025-10-15T10:30:00.000Z",
    "updatedAt": "2025-10-15T10:30:00.000Z"
  },
  "success": true
}

Описание полей ответа

Поле	Тип	Описание
requestId	string	Уникальный идентификатор запроса
success	boolean	Статус выполнения запроса (true/false)
result	object	Объект с юридическими данными организации
id	string (uuid)	Идентификатор юридических данных
organisationId	string (uuid)	Идентификатор организации
version	number	Версия юридических данных
legalForm	string, null	Организационно-правовая форма (например, ООО)
shortLegalName	string	Краткое юридическое название
fullLegalName	string	Полное юридическое название
inn	string	ИНН
ogrn	string, null	ОГРН
kpp	string, null	КПП
city	string, null	Город
representativeFullName	string, null	ФИО представителя
representativePosition	string, null	Должность представителя
representativeAuthority	string, null	Основание полномочий
address	string, null	Юридический адрес
comment	string, null	Комментарий
createdAt	string	Дата создания
updatedAt	string	Дата обновления