Коды регионов
ГосПлан API использует региональные коды из классификатора адресов России (КЛАДР) для фильтрации закупок, контрактов и контрагентов. На этой странице собраны пояснения о том, как определяется код региона в системах ЕИС и КЛАДР, как его использовать в запросах к API и полный справочник субъектов РФ с кодами.
Как определяется регион по КЛАДР
Источником кодов регионов служит справочник организаций nsiOrganization из НСИ ЕИС. У каждой организации в ответе НСИ есть поле factualAddress/region/kladrCode, которое содержит полный КЛАДР-идентификатор фактического адреса.
Региональный код для ГосПлан API берётся только из первых двух символов этого поля:
- первые два знака однозначно определяют субъект РФ (республику, край, область, город федерального значения, автономный округ и т.д.);
- остальные цифры КЛАДР-кода описывают район, город, населённый пункт, улицу и не используются при фильтрации по субъекту;
- таким образом, региональный код представляет собой краткую часть КЛАДР‑идентификатора, которая всегда повторяет код области/региона, принятый в официальном классификаторе.
Структура регионального кода
Полный КЛАДР-код состоит из 13 цифр, но для целей региональной фильтрации короткая часть (первые два знака) достаточна. В параметре region ГосПлан API ожидает числовое значение без ведущих нулей. Например:
region = 1— для Республики Адыгея;region = 77— для Москвы;region = 78— для Санкт-Петербурга;region = 23— для Краснодарского края.
Если в справочниках ЕИС код записан с ведущим нулём (01, 02 и т.п.), при отправке запроса в ГосПлан API используйте числовой эквивалент (1, 2). При необходимости массив кодов регионов передаётся в формате, принимаемом конкретным эндпоинтом (см. Swagger-описания в разделе /api).
Справочник кодов регионов
Коды регионов определяются на основе первых двух символов factualAddress/region/kladrCode и соответствуют официальному КЛАДР. Ниже приведён полный справочник субъектов Российской Федерации и сопредельных территорий с кодами ГосПлан API.
| Наименование региона | Код региона |
|---|---|
| Адыгея респ. | 1 |
| Алтай респ. | 4 |
| Алтайский край | 22 |
| Амурская область | 28 |
| Архангельская область | 29 |
| Астраханская область | 30 |
| Байконур г. | 99 |
| Башкортостан | 2 |
| Белгородская область | 31 |
| Брянская область | 32 |
| Бурятия | 3 |
| Владимирская область | 33 |
| Волгоградская область | 34 |
| Вологодская область | 35 |
| Воронежская область | 36 |
| Дагестан респ. | 5 |
| ДНР | 93 |
| Еврейская автономная область | 79 |
| Забайкальский край | 75 |
| Запорожская область | 90 |
| Ивановская область | 37 |
| Ингушетия респ. | 6 |
| Иркутская область | 38 |
| Кабардино-Балкария респ. | 7 |
| Калининградская область | 39 |
| Калмыкия респ. | 8 |
| Калужская область | 40 |
| Камчатский край | 41 |
| Карачаево-Черкесская респ. | 9 |
| Карелия респ. | 10 |
| Кемеровская область | 42 |
| Кировская область | 43 |
| Коми респ. | 11 |
| Костромская область | 44 |
| Краснодарский край | 23 |
| Красноярский край | 24 |
| Крым респ. | 91 |
| Курганская область | 45 |
| Курская область | 46 |
| Ленинградская область | 47 |
| Липецкая область | 48 |
| ЛНР | 94 |
| Магаданская область | 49 |
| Марий Эл респ. | 12 |
| Мордовия респ. | 13 |
| Москва | 77 |
| Московская область | 50 |
| Мурманская область | 51 |
| Ненецкий автономный округ | 83 |
| Нижегородская область | 52 |
| Новгородская область | 53 |
| Новосибирская область | 54 |
| Омская область | 55 |
| Оренбургская область | 56 |
| Орловская область | 57 |
| Пензенская область | 58 |
| Пермский край | 59 |
| Приморский край | 25 |
| Псковская область | 60 |
| Ростовская область | 61 |
| Рязанская область | 62 |
| Самарская область | 63 |
| Санкт-Петербург | 78 |
| Саратовская область | 64 |
| Саха (Якутия) респ. | 14 |
| Сахалинская область | 65 |
| Свердловская область | 66 |
| Севастополь г. | 92 |
| Северная Осетия - Алания респ. | 15 |
| Смоленская область | 67 |
| Ставропольский край | 26 |
| Тамбовская область | 68 |
| Татарстан респ. | 16 |
| Тверская область | 69 |
| Томская область | 70 |
| Тыва респ. | 17 |
| Тульская область | 71 |
| Тюменская область | 72 |
| Удмуртская респ. | 18 |
| Ульяновская область | 73 |
| Хабаровский край | 27 |
| Хакасия респ. | 19 |
| Ханты-Мансийский автономный округ - Югра | 86 |
| Херсонская область | 95 |
| Челябинская область | 74 |
| Чеченская респ. | 20 |
| Чувашская респ. | 21 |
| Чукотский автономный округ | 87 |
| Ямало-Ненецкий автономный округ | 89 |
| Ярославская область | 76 |
Как использовать коды регионов в запросах
- Передавайте
regionв запросах, чтобы ограничить выборку по субъекту РФ. - При выборе одного региона используйте числовой код из таблицы выше (
region = 77— Москва,region = 22— Алтайский край, и т.д.). - Для фильтрации по нескольким регионам передавайте массив кодов (
region = [23, 24, 25]). - Сочетайте
regionс другими параметрами (например,fz, временные фильтры, категории закупок), чтобы получить нужный срез данных.
Актуальность и обновление справочника
Список регионов формируется на основе данных НСИ ЕИС и классификатора КЛАДР. Если административно-территориальное деление изменяется (появляется новый субъект, меняется статус региона), мы обновляем таблицу на этой странице. Обновления происходят синхронно с релизами НСИ и публикациями ЕИС.
Если вы заметили расхождение между данными на этой странице и актуальным классификатором ЕИС — сообщите через контактную форму на странице /contacts, чтобы мы могли быстро актуализировать справочник.
Связанные материалы
- /docs/dictionaries/nsi — подробное описание XML-справочников ЕИС, включая
nsiOrganizationи источники КЛАДР-кодов. - /docs/guides/history-data — практический пример анализа данных по регионам и фильтрации исторических трендов.
- /api — обзор доступных эндпоинтов и Swagger-сценариев, где встречается параметр
region.