2026-04-11 09:44:22

Общероссийский классификатор продукции по видам экономической деятельности (ОКПД 2)

Поиск по коду ОКПД 2

Метод: GET

Эндпоинт: /api/classifier/v1/okpd/{code}

Где {code} — код классификатора ОКПД 2.

Поддерживаемые форматы кода

  • 01 — класс
  • 01.1 — подкласс
  • 01.11 — группа
  • 01.11.2 — подгруппа
  • 01.11.20 — вид (тип)
  • 01.11.20.110 — категория

Также поддерживается передача кода числом без точек.

Например:

  • 11120110 - категория

  • 11120000 - вид

  • 11000000 - группа

  • 1 - класс

Максимальная глубина: 4 уровня (класс → подкласс → группа → подгруппа/вид/категория).

Примеры успешных запросов

Класс:

GET /api/classifier/v1/okpd/01
Ответ:
{
  "class": {
    "id": "01",
    "code_id": "A",
    "name": "Продукция и услуги сельского хозяйства и охоты"
  }
}
Полная категория:
GET /api/classifier/v1/okpd/01.11.20.110
Ответ содержит все уровни иерархии:
{
  "subclass": { ... },
  "group": { ... },
  "subgroup": { ... },
  "category": {
    "type_id": "20",
    "id": "01.11.20.110",
    "name": "Кукуруза лопающаяся (рисовая)"
  },
  "type": { ... },
  "class": { ... }
}

Ошибки при поиске по коду

Код ответа Сообщение Причина
400 “класс, группа и вид должны состоять из двух цифр” Неправильное количество цифр в сегменте (например, 111 вместо 01.11)
400 “неверный формат кода классификатора” Код содержит недопустимые символы
400 “код классификатора должен состоять максимум из 4 элементов, разделенных точкой” Слишком много уровней (более 4)
400 “не указан код классификатора или поисковый запрос” Пустой запрос

Поиск по названию

Метод: GET

Эндпоинт: /api/classifier/v1/okpd/?query={search}

Параметры: - query — поисковый запрос (строка)

Минимальная длина запроса: 4 символа

Пример

GET /api/classifier/v1/okpd/?query=кукуруза
Ответ:
{
  "subgroup": [
    {
      "id": "01.11.2",
      "name": "Кукуруза",
      "group_id": "11"
    }
  ],
  "category": [
    { "id": "01.11.20.110", "name": "Кукуруза лопающаяся (рисовая)", "type_id": "20" },
    ...
  ],
  "type": [
    {
      "id": "01.11.20",
      "subgroup_id": "11",
      "name": "Кукуруза"
    }
  ]
}
Ошибка: - 400 “поисковый запрос должен содержать не менее 4 символов” — если длина запроса меньше 4 символов.


Структура ответа

API возвращает объекты иерархии ОКПД 2 в зависимости от уровня запрошенного кода:

  • class — Класс (уровень 1)
  • subclass — Подкласс (уровень 2)
  • group — Группа (уровень 3)
  • subgroup — Подгруппа (уровень 4)
  • type — Вид / Тип (уровень 5)
  • category — Категория (уровень 6)

Каждый объект содержит: - id — код уровня - name — наименование - Ссылки на родительские уровни (class_id, subclass_id, group_id и т.д.)