---
title: "Получить юрлица для фильтров и полей выбора"
method: GET
path: "/api/v1/settings/companies/selectable"
tags: ["Settings companies"]
---

# Получить юрлица для фильтров и полей выбора

`GET /api/v1/settings/companies/selectable`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/settings/companies/selectable`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Действующие юрлица всегда, отключённые — только если по ним есть проведённые непомеченные документы. Полный справочник отдаёт другой маршрут.

## Headers

- `X-Tenant` string, required

## Response `200`

Юрлица для выбора

- SettingsCompanyPage
  - `count` integer, required: Число отданных строк, страниц у справочника нет
  - `results` SettingsCompany[], required
    - `id` string, uuid, required
    - `business_id` string, uuid, required
    - `name` string, required
    - `legal_name` string, required
    - `entity_type` 'legal' | 'sole_prop', required: Юридическое лицо или индивидуальный предприниматель
    - `inn` string, required: Пустой только у юрлица внутреннего учёта
    - `kpp` string, required
    - `ogrn` string, required: ОГРН у юрлица или ОГРНИП у предпринимателя
    - `okpo` string, required: ОКПО; необязательный реквизит формализованного документа
    - `branch_code` string, required: Код филиала у оператора ЭДО; не КПП
    - `vat_accounting_mode` '' | 'deductible' | 'non_deductible' | 'none', required: Режим налога, действующий сегодня (версия учётной политики): deductible — в вычет, non_deductible — в стоимость, none — налога нет, пусто — не выбран
    - `vat_accounting_mode_source` 'manual' | 'import', required: Кто поставил значение: manual — человек, import — внешняя система; импорт не перезаписывает manual
    - `legal_address` SettingsCompanyAddress, required
      - `postal_code` string, required
      - `region_code` string, required: Код субъекта РФ для формализованного документа
      - `region_name` string, required
      - `district` string, required
      - `city` string, required
      - `settlement` string, required
      - `street` string, required
      - `building` string, required
      - `block` string, required
      - `flat` string, required: Офис или помещение
      - `info` string, required: Дополнение, которое не раскладывается по остальным частям адреса
    - `entrepreneur` SettingsCompanyPerson, required
      - `surname` string, required
      - `name` string, required
      - `patronymic` string, required
      - `ogrnip_date` string, date: Дата присвоения ОГРНИП; с 01.04.2026 печатается в счёте-фактуре под подписью ИП вместе с ОГРНИП
    - `head` SettingsCompanyHead: Руководитель юрлица полным ФИО и должностью — подписант документов без доверенности; ФИО как в сертификате подписи
      - `surname` string
      - `name` string
      - `patronymic` string
      - `position` string
    - `is_active` boolean, required
    - `custom` object, required: Значения своих полей кабинета: графа («Настройки → Поля», вид core.company) → значение
    - `closing_control` boolean: Контроль закрывающих документов по выданным авансам: вкладка «Ждём закрывающие» ведёт авансы этого юрлица. Для режима «доходы минус расходы» обязателен, на «доходах» не нужен

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)