Перейти к основному содержанию
GET
Компания

Авторизации

tungo.session_token
string
cookie
обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

co
string
обязательно

Компания (co_…)

Пример:

"co_01jz8x3m4n5p6q7r8s9t0v1w2x"

Ответ

Компания

Компания — одна база 1С: её данные, предложения, чат. Доступ — по членству и роли в компании

id
string
обязательно

Компания — её id во всех адресах /v1/companies/{co}/… (co_…)

Пример:

"co_01jz8x3m4n5p6q7r8s9t0v1w2x"

workspace_id
string
обязательно

Организация, которой принадлежит компания (кто платит) (ws_…)

Пример:

"ws_01jz8x3m4n5p6q7r8s9t0v1w2x"

name
string
обязательно

Название компании, как его ввели при заведении

Пример:

"ТОО «Пример Сервис»"

bin
string | null
обязательно

БИН или ИИН, 12 цифр; null — ещё не указан

Пример:

"000000000000"

Форма: ip — ИП, too — ТОО, ao — АО, other — другое

Доступные опции:
ip,
too,
ao,
other
status
enum<string>
обязательно

active — работает; suspended — приостановлена (запросы к ней — 403 company_suspended); archived — в архиве

Доступные опции:
active,
suspended,
archived
role
string
обязательно

Ваша роль в компании (ключ роли: owner, chief_accountant, accountant, viewer…). Пустая строка — вы не участник компании, а владелец/админ организации, который её правил или архивировал

role_name
string
обязательно

Название вашей роли для показа

Пример:

"Владелец"

permissions
enum<string>[]
обязательно

Ваши права в этой компании — по ним кабинет прячет или гасит кнопки (нет proposals.approve — нет «Одобрить»). По ключу API — права, суженные до прав ключа. Порядок — как в каталоге прав

Право в компании:

  • company.read — Видеть компанию и её данные
  • company.manage — Менять настройки компании
  • company.members.manage — Приглашать и убирать участников, менять роли
  • onec.connect — Подключать и настраивать 1С
  • proposals.create — Готовить документы для 1С
  • proposals.approve — Одобрять запись документов в 1С
  • chat.use — Пользоваться ИИ-бухгалтером
  • audit.read — Читать журнал действий компании
  • automations.manage — Заводить и менять автоматизации компании: хуки и сценарии
Доступные опции:
company.read,
company.manage,
company.members.manage,
onec.connect,
proposals.create,
proposals.approve,
chat.use,
audit.read,
automations.manage
created_at
string<date-time>
обязательно

Когда компанию завели. ISO 8601 в UTC (…Z); показывать по времени Казахстана — Asia/Almaty (UTC+5), а не по поясу браузера

Пример:

"2026-10-05T09:30:00.000Z"