Организация
Получение информации об организации
Метод возвращает основную информацию об организации по её идентификатору.
Запрос
Метод: GET URL: https://b2b.selfwork.ru/openapi/v2/organisations/{organisationId}
Path Parameters
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| organisationId | string (uuid) | Да | Идентификатор организации |
Пример запроса
curl --location "https://b2b.selfwork.ru/openapi/v2/organisations/550e8400-e29b-41d4-a716-446655440000" \
--header "Authorization: Bearer ВАШ_API_КЛЮЧ"
Пример успешного ответа
{
"requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
"success": true,
"result": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "LLC Horns and Hooves",
"inn": "7707083893",
"metadata": {
"segment": "marketplace"
},
"createdAt": "2025-10-15T10:30:00.000Z",
"updatedAt": "2025-10-15T10:30:00.000Z"
}
}
Описание полей ответа
| Поле | Тип | Описание |
|---|---|---|
| requestId | string | Уникальный идентификатор запроса |
| success | boolean | Статус выполнения запроса (true/false) |
| result | object | Контейнер с данными организации |
| result.id | string (uuid) | ID организации |
| result.name | string | Название организации |
| result.inn | string | ИНН организации |
| result.metadata | object | Произвольные метаданные организации |
| result.createdAt | string | Дата создания (ISO 8601) |
| result.updatedAt | string | Дата обновления (ISO 8601) |
Возможные ошибки
| Code | Описание |
|---|---|
| VALIDATION_ERROR | Ошибка валидации |
| FORBIDDEN_ERROR | Ошибка авторизации |
| UNKNOWN_ERROR | Ошибка сервера |