Организации клиента

POST https://gptunnel.ru/api/v1/orgs/list

Возвращает организации, в которых пользователь — действующий владелец, с текущим балансом и реквизитами каждой. Личный счёт пользователя в список не входит: его баланс отдаёт balance/get по user_id.

Полученные org_id подходят для перевода, просмотра баланса, отчёта о тратах и возврата.

Метод только читает данные, заголовок Idempotency-Key не нужен.

Headers

Параметр	Тип	Описание
`Authorization`*	`string`	API ключ организации
`Content-Type`*	`string`	application/json

Параметры запроса

Параметр	Тип	Описание
`user_id`	`string`	ID пользователя-клиента, 24 hex-символа строчными. Ровно одно из user_id и user_data
`user_data`	`object`	Поиск пользователя по телефону: { "phone": "+79XXXXXXXXX" }. Подключается отдельно, см. обзор

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

curl --request POST \
  --url https://gptunnel.ru/api/v1/orgs/list \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "user_id": "6ad72133269dc8d9f75a33bc"
}'

import axios from 'axios'

const response = await axios({
  method: 'POST',
  url: 'https://gptunnel.ru/api/v1/orgs/list',
  headers: { Authorization: 'YOUR_API_KEY' },
  data: { user_id: '6ad72133269dc8d9f75a33bc' },
})

console.log(response.data)

import requests

response = requests.post(
    'https://gptunnel.ru/api/v1/orgs/list',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'user_id': '6ad72133269dc8d9f75a33bc'},
)

print(response.json())

Ответ

Поля ответа

Параметр	Тип	Описание
`code`	`number`	0 при успехе
`user_id`	`string`	ID пользователя, чьи организации возвращены
`orgs`	`array`	Организации пользователя по дате создания, от старых к новым. Пустой массив, если организаций нет

Элемент orgs

Параметр	Тип	Описание
`org_id`	`string`	ID организации
`name`	`string`	Название
`account`	`string \| null`	Номер лицевого счёта организации
`balance`	`number`	Остаток на счёте в рублях. Может быть отрицательным
`credit_limit`	`number`	Кредитный лимит в рублях, 0 если не назначен
`inn`	`string \| null`	ИНН
`ogrn`	`string \| null`	ОГРН
`created_at`	`string`	Дата создания, ISO 8601

200 OK
200 Организаций нет

{
  "code": 0,
  "user_id": "6ad72133269dc8d9f75a33bc",
  "orgs": [
    {
      "org_id": "6ad7a4f2269dc8d9f75a41d0",
      "name": "ООО «Ромашка»",
      "account": "ЛСО-10452",
      "balance": 18250,
      "credit_limit": 0,
      "inn": "7701234567",
      "ogrn": "1027700123456",
      "created_at": "2026-10-21T10:02:44.000Z"
    }
  ]
}

{
  "code": 0,
  "user_id": "6ad72133269dc8d9f75a33bc",
  "orgs": []
}

Ошибки

HTTP	code	Когда
400	3	Тело не по схеме: нет пользователя, указаны оба поля, лишнее поле, id не из 24 символов `0-9a-f`. Подробности — в поле `details`
403	13	Ключ личного аккаунта, а не организации
403	27	Поиск по `user_data` организации не подключён
403	36	Организации ключа метод не подключён
404	17	Пользователь не найден, удалён или не является клиентом партнёра

Ключ проверяется раньше тела: ключ без доступа получит 403 даже на запрос с телом не по схеме.

Полный список кодов и ответ 401 на неверный ключ — в справочнике ошибок.