Федеральные округа и регионы

Данные о федеральных округах

Получение справочной информации о ФО

GET запрос на /fed-districts-reference/?apikey={apikey}&format=json&page={page}

Список параметров:

Название параметра	Значение
apikey	API ключ для запроса
format	json
page	Порядковый номер страницы результатов (для последующих запросов).

Ответы:

В случае отсутствия данных в ответе, в значении поля вернется null. В случае наличия данных, вернется ответ в формате {код: описание}, например:

 {
  "YUFO": "Южный федеральный округ",
  "DFO": "Дальневосточный федеральный округ",
  "CFO": "Центральный федеральный округ",
  "URFO": "Уральский федеральный округ",
  "SZFO": "Северо-Западный федеральный округ",
  "SKFO": "Северо-Кавказский федеральный округ",
  "PFO": "Приволжский федеральный округ",
  "SFO": "Сибирский федеральный округ"
}

Получение справочной информации о регионах

GET запрос на /regions-reference/?apikey={apikey}&format=json&page={page}

Ответы:

{
  "10": "Республика Карелия",
  "11": "Республика Коми",
  "12": "Республика Марий Эл",
  "13": "Республика Мордовия",
  "14": "Республика Саха",
  "15": "Республика Северная Осетия - Алания",
  "16": "Республика Татарстан",
  "17": "Республика Тыва",
  "18": "Удмуртская Республика",
  "19": "Республика Хакасия",
  "20": "Чеченская Республика",
  ...
}

Получение справочной информации об иерархических связях ФО и регионаальных субъектах

GET запрос на fd-regions-reference/?apikey={apikey}&format=json&page={page}

Ответы:

В случае отсутствия данных в ответе, в значении поля вернется null. В случае наличия данных, вернется ответ в формате {код ФО: [коды регионов,]}, например:

{
  "CFO": [
    "31",
    "32",
    "33",
    "36",
    "37",
    "40",
    "44",
    "46",
    "48",
    "50",
    "57",
    "62",
    "67",
    "68",
    "69",
    "71",
    "76",
    "77"
  ], ...
}

Список регионов

GET запрос на regions/?apikey={apikey}&format=json&page={page}

Ответ возвращает записи, каждая из которых содержит данные для региона за запрашиваемый год. Единого логического идентификатора у записей нет, они идентифицируются как сочетание:

кода региона (region_code)
года (year)

Пример ответа:

В случае отсутствия данных в ответе, в значении поля вернется null.

{
  "count": 85,
  "page_size": 20,
  "total_pages": 5,
  "page": 1,
  "data": [
    {
      "admin_centre": "Майкоп",
      "alt_name": " Адыгея",
      "budget": null,
      "contracts223_count": 4411,
      "contracts223_sum": 12236951580.82,
      "contracts44_count": 92416,
      "contracts44_sum": 139542414268.19,
      "customers223_count": 70,
      "customers44_count": 755,
      "description": null,
      "federal_district_code": "YUFO",
      "federal_district_name": "Южный федеральный округ",
      "okato_code": "79",
      "order": 45,
      "region_code": "01",
      "region_name": "Республика Адыгея",
      "region_type": "республика",
      "suppliers223_count": 417,
      "suppliers44_count": 7538,
      "year": null
    },

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

ВАЖНО Поле year может содержать как числовое значение (год), так и null. В случае, если значение не null, представленные в записи суммы и количества относятся к этому году. Если "year": null, то представленные в записи суммы и количества содержат значения за всё время.

Название поля	Тип данных	Значение
contracts223_count	number	Количество договоров по 223-ФЗ за период
contracts223_sum	number	Сумма договоров по 223-ФЗ за период
contracts44_count	number	Количество контрактов 44-ФЗ за период
contracts44_sum	number	Сумма контрактов 44-ФЗ за период
customers223_count	number	Количество заказчиков по 223-ФЗ за период
customers44_count	number	Количество заказчиков 44-ФЗ за период
admin_centre	string	Административный центр
alt_name	string	Альтернативное наименование региона
budget	number	Бюджет региона, если данные недоступны, то `null`
description	string	Описание субъекта если данные недоступны,то `null`
suppliers223_count	number	Количество поставщиков по 223-ФЗ за год
suppliers44_count	number	Количество поставщиков по 44-ФЗ за год
year	null / number	Год, за который данные
federal_district_code	string	Код ФО
federal_district_name	string	Наименование ФО
okato_code	string	Код ОКАТО
order	number	Положение региона при логической сортировки внутри федерального округа
region_code	string	Код региона
region_name	string	Наименование региона
region_type	string	Тип региона

Фильтрация регионов

По коду региона

GET запрос на: regions/?region_code=10&apikey={apikey}

Если отправить в качестве параметра только код региона, без уточнения параметра year, то вернутся только записи, у которых "year": null, то есть только суммарные значения за всё время.

Структура ответа 200 аналогична общей структуре ответа, описанного выше.

По году

GET запрос на: regions/?year=2024&apikey={apikey}

Структура ответа 200 аналогична общей структуре ответа, описанного выше.

По коду ФО

GET запрос на: regions/?federal_district_code=DFO&apikey={apikey}

Структура ответа 200 аналогична общей структуре ответа, описанного выше.

Если отправить в качестве параметра только код ФО, без уточнения параметра year, то вернутся только записи, у которых "year": null, то есть только суммарные значения за всё время.

По коду региона и году

GET запрос на: regions/?region_code=10&year=2024&apikey={apikey}

Структура ответа 200 аналогична общей структуре ответа, описанного выше.

Список федеральных округов (ФО)

GET запрос на: fed-districts/?apikey={apikey}&format=json&page={page}

Ответ возвращает записи, каждая из которых содержит данные для ФО за указанный год. Единого логического идентификатора у записей нет, они идентифицируются как:

кода ФО (fed_district_code)
года (year), за который запрашиваются данные

Структура ответа 200 аналогична общей структуре ответа, описанного ниже в данном разделе.

Общий справочник

fed_district_code	full_name
CFO	Центральный федеральный округ
SZFO	Северо-Западный федеральный округ
YUFO	Южный федеральный округ
SKFO	Северо-Кавказский федеральный округ
PFO	Приволжский федеральный округ
URFO	Уральский федеральный округ
SFO	Сибирский федеральный округ
DFO	Дальневосточный федеральный округ

Фильтрация ФО

По году

GET запрос на: fed-districts/?year=2024&apikey={apikey}

По коду ФО

GET запрос на: fed-districts/?federal_district_code=DFO&apikey={apikey}

Если отправить в качестве параметра только код ФО, без уточнения year, то вернутся только записи, у которых "year": null, то есть только суммарные значения за всё время.

По году и коду ФО

GET запрос на: fed-districts/?year=2023&federal_district_code=DFO&apikey={apikey}

Общий пример ответа:

200

{
  "count": 1,
  "page_size": 20,
  "total_pages": 1,
  "page": 1,
  "data": [
    {
      "admin_centre": "Владивосток",
      "budget": null,
      "contracts223_count": 119201,
      "contracts223_sum": 781270609787.5,
      "contracts44_count": 241904,
      "contracts44_sum": 662113233988.36,
      "customers223_count": 2770,
      "customers44_count": 10762,
      "federal_district_code": "DFO",
      "federal_district_name": "Дальневосточный федеральный округ",
      "num_regions": 11,
      "order": 8,
      "short_name": "ДФО",
      "start_year": 2000,
      "suppliers223_count": null,
      "suppliers44_count": 38101,
      "year": 2023
    }
  ]
}

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество текущих данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

ВАЖНО Поле year может содержать как числовое значение (год), так и null. В случае, если значение не null, представленные в записи суммы и количества относятся к этому году. Если "year": null, то представленные в записи суммы и количества содержат значения за всё время.

Название поля	Тип данных	Значение
contracts223_count	number	Количество договоров по 223-ФЗ за год
contracts223_sum	number	Сумма договоров по 223-ФЗ за год
contracts44_count	number	Количество контрактов 44-ФЗ за год
contracts44_sum	number	Сумма контрактов 44-ФЗ за год
customers223_count	number	Количество заказчиков по 223-ФЗ за год
customers44_count	number	Количество заказчиков 44-ФЗ за год
admin_centre	string	Административный центр
budget	number	Бюджет ФО
federal_district_code	string	Код ФО
federal_district_name	string	Наиименование ФО
num_regions	number	Количество региональных субъектов внутри ФО
year	null / number	Год, за который данные
order	number	Положение ФО при логической сортировки
short_name	string	Аббревиатура наименования ФО
suppliers223_count	number	Количество поставщиков по 223-ФЗ за год
suppliers44_count	number	Количество поставщиков по 44-ФЗ за год
start_year	number	Год выделения ФО

Топы контрактов, заказчиков и поставщиков

Регональные субъекты

Специальные эндпойнты, которые отображают топы-20 поставщиков и заказчиков, отсортированные по сумме или по количеству контрактов с фильтрацией по ФЗ, году и региону.

GET запрос на: regions-customers-top/ - по заказчикам
GET запрос на: regions-suppliers-top/ - по поставщикам

Для каждого региона, года и ФЗ используется соответствующая комбинация фильтров, а также нужно указать признак сортировки:

-total_sum - по сумме контрактов
-total_count - по количеству контрактов

Пример запроса по топу заказчиков для региона с кодом 10, за 2023 год, по 44-ФЗ по количеству контрактов:

regions-customers-top/?fz=44&region_code=10&year=2023&sort=-total_count&page=1&page_size=20

Пример ответа:

{
  "count": 29,
  "page_size": 20,
  "total_pages": 2,
  "page": 1,
  "data": [
    {
      "customer_inn": "1001046786",
      "customer_name": "ГОСУДАРСТВЕННОЕ КАЗЁННОЕ УЧРЕЖДЕНИЕ РЕСПУБЛИКИ КАРЕЛИЯ \"ЦЕНТР БУХГАЛТЕРСКОГО УЧЁТА И ОРГАНИЗАЦИИ ЗАКУПОК ПРИ МИНИСТЕРСТВЕ ЗДРАВООХРАНЕНИЯ РЕСПУБЛИКИ КАРЕЛИЯ\"",
      "federal_district_code": "SZFO",
      "fz": "44",
      "region_code": "10",
      "region_name": "Республика Карелия",
      "total_count": 845,
      "total_sum": 1654206190.17,
      "year": 2023
    },

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество заказчиков в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

Название поля	Тип данных	Значение
customer_inn	string	ИНН заказчика
customer_name	string	Наименование заказчика
fz	string	ФЗ
federal_district_code	string	Код ФО
region_code	string	Код региона
region_name	string	Наименование региона
total_count	number	Общее количество контрактов заказчика в рамках региона
total_sum	number	Общая сумма контрактов заказчика в рамках региона
year	number	Год, за который данные

Пример запроса по топу поставщиков для региона с кодом 10, за 2023 год, по 44-ФЗ по сумме контрактов:

regions-suppliers-top?fz=44&region_code=10&year=2023&sort=-total_sum&page=1&page_size=20

Пример ответа:

{
  "count": 34,
  "page_size": 20,
  "total_pages": 2,
  "page": 1,
  "data": [
    {
      "federal_district_code": "SZFO",
      "fz": "44",
      "region_code": "10",
      "region_name": "Республика Карелия",
      "supplier_inn": "7813250320",
      "supplier_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ТЕХНОСТРОЙ\"",
      "total_count": 2,
      "total_sum": 7747150434,
      "year": 2023
    },

Описание данных в data

Название поля	Тип данных	Значение
supplier_inn	string	ИНН поставщика
supplier_name	string	Наименование поставщика
fz	string	ФЗ
federal_district_code	string	Код ФО
region_code	string	Код региона
region_name	string	Наименование региона
total_count	number	Общее количество контрактов поставщика в рамках региона
total_sum	number	Общая сумма контрактов поставщика в рамках региона
year	number	Год, за который данные

GET запрос на: /regions-contracts-top/ - по контрактам

Фильтры остаются теми же, это: ФЗ, код региона, год. Признак сортировки только -amount_rur.

Пример запроса по топу контрактов для региона с кодом 10, за 2024 год, по 44-ФЗ

regions-contracts-top/?region_code=10&year=2024&fz=44

Пример ответа:

{
  "count": 20,
  "page_size": 20,
  "total_pages": 1,
  "page": 1,
  "data": [
    {
      "amount_rur": 3261817912,
      "customer_inn": "1001117010",
      "customer_name": "ФЕДЕРАЛЬНОЕ КАЗЕННОЕ УЧРЕЖДЕНИЕ \"УПРАВЛЕНИЕ АВТОМОБИЛЬНОЙ МАГИСТРАЛИ САНКТ-ПЕТЕРБУРГ - МУРМАНСК ФЕДЕРАЛЬНОГО ДОРОЖНОГО АГЕНТСТВА\"",
      "federal_district_code": "SZFO",
      "fz": "44",
      "prod_name": "Капитальный ремонт автомобильной дороги А-215 Лодейное Поле - Вытегра - Прокшино - Плесецк - Брин-Наволок, подъезд к г. Петрозаводску на участке км 43 - км 58, Республика Карелия. Разработка рабочей документации",
      "region_code": "10",
      "regnum": "1100111701024000013",
      "sign_date": "2024-05-02",
      "subject": "Капитальный ремонт автомобильной дороги А-215 Лодейное Поле - Вытегра - Прокшино - Плесецк - Брин-Наволок, подъезд к г. Петрозаводску на участке км 43 - км 58, Республика Карелия, включая разработку рабочей документации, выполнение работ по сохранению выявленного объекта археологического наследия «Поселение Другая Река I» и проведение государственной историко-культурной экспертизы, выполнение работ по очистке от взрывоопасных предметов территории строительной площадки.",
      "year": 2024
    }, ...
    ]
}

Описание данных в data

Название поля	Тип данных	Значение
customer_inn	string	ИНН заказчика
customer_name	string	Наименование заказчика
fz	string	ФЗ
federal_district_code	string	Код ФО
prod_name	string	Наименование объекта закупки/товара/работы/услуги
regnum	string	Номер контракта
sign_date	string	Дата подписания контракта
subject	string	Предмет контракта
amount_rur	number	Общая сумма контрактов
region_code	string	Код региона
year	number	Год, за который данные

Федеральные округа

Специальные эндпойнты, которые отображают топы-20 поставщиков и заказчиков, отсортированные по сумме или по количеству контрактов с фильтрацией по ФЗ, году и коду ФО.

GET запрос на: fed-districts-customers-top/ - по заказчикам
GET запрос на: fed-districts-suppliers-top/ - по поставщикам

Для каждого ФО, года и ФЗ используется соответствующая комбинация фильтров, а также нужно указать признак сортировки:

-total_sum - по сумме контрактов
-total_count - по количеству контрактов

Пример запроса по топу заказчиков для ФО с кодом DFO, за 2023 год, по 44-ФЗ по количеству контрактов:

fed-districts-customers-top?fz=44&federal_district_code=DFO&year=2023&sort=-total_count&page=1&page_size=20

Пример ответа:

{
  "count": 209,
  "page_size": 20,
  "total_pages": 11,
  "page": 1,
  "data": [
    {
      "customer_inn": "6501025568",
      "customer_name": "ГОСУДАРСТВЕННОЕ БЮДЖЕТНОЕ УЧРЕЖДЕНИЕ ЗДРАВООХРАНЕНИЯ \"САХАЛИНСКАЯ ОБЛАСТНАЯ КЛИНИЧЕСКАЯ БОЛЬНИЦА\"",
      "federal_district_code": "DFO",
      "federal_district_name": "Дальневосточный федеральный округ",
      "fz": "44",
      "total_count": 1534,
      "total_sum": 2808719642.55,
      "year": 2023
    },

Описание данных в data

Название поля	Тип данных	Значение
customer_inn	string	ИНН заказчика
customer_name	string	Наименование заказчика
fz	string	ФЗ
federal_district_code	string	Код ФО
federal_district_name	string	Наименование ФО
total_count	number	Общее количество контрактов заказчика в разрезе ФО
total_sum	number	Общая сумма по контрактам заказчика в разрезез ФО
year	number	Год, за который данные

Пример запроса по топу поставщиков для региона с кодом DFO, за 2023 год, по 44-ФЗ по сумме контрактов:

fed-districts-suppliers-top?fz=44&federal_district_code=DFO&year=2023&sort=-total_sum&page=1&page_size=20

Пример ответа:

{
    "count": 189,
    "page_size": 20,
    "total_pages": 10,
    "page": 1,
    "data": [
        {
            "federal_district_code": "DFO",
            "federal_district_name": "Дальневосточный федеральный округ",
            "fz": "44",
            "supplier_inn": "1435133520",
            "supplier_name": "ГОСУДАРСТВЕННОЕ УНИТАРНОЕ ПРЕДПРИЯТИЕ \"ЖИЛИЩНО-КОММУНАЛЬНОЕ ХОЗЯЙСТВО РЕСПУБЛИКИ САХА (ЯКУТИЯ)\"",
            "total_count": 1937,
            "total_sum": 8077120982.77,
            "year": 2023
        },

Описание данных в data

Название поля	Тип данных	Значение
supplier_inn	string	ИНН поставщика
supplier_name	string	Наименование поставщика
fz	string	ФЗ
federal_district_code	string	Код ФО
federal_district_name	string	Наименование ФО
total_count	number	Общее количество контрактов поставщика в разрезе ФО
total_sum	number	Общая сумма по контрактам поставщика в разрезе ФО
year	number	Год, за который данные

GET запрос на: /fed-districts-contracts-top - по контрактам

Фильтры остаются теми же, это: ФЗ, код ФО, год. Признак сортировки только -amount_rur.

Пример запроса по топу контрактов для региона с кодом DFO, за 2024 год, по 44-ФЗ

fed-districts-contracts-top?federal_district_code=DFO&year=2024&sort=-amount_rur&page=1&page_size=20

Пример ответа:


{
    "count": 40,
    "page_size": 20,
    "total_pages": 2,
    "page": 1,
    "data": [
        {
            "amount_rur": 25749473100.0,
            "customer_inn": "6500000024",
            "customer_name": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО ЭНЕРГЕТИКИ И ЭЛЕКТРИФИКАЦИИ \"САХАЛИНЭНЕРГО\"",
            "federal_district_code": "DFO",
            "fz": "223",
            "prod_name": "Услуги по продаже потребителям газа, подаваемого по распределительным трубопроводам",
            "regnum": "56500000024240000170000",
            "sign_date": "2024-01-12",
            "subject": "Природный газ для нужд ОП \"Южно-Сахалинская ТЭЦ-1\"",
            "year": 2024
        },

Описание данных в data

Название поля	Тип данных	Значение
customer_inn	string	ИНН заказчика
customer_name	string	Наименование заказчика
fz	string	ФЗ
federal_district_code	string	Код ФО
prod_name	string	Наименование продукта/товара/работы/услуги контракта
regnum	string	Номер контракта
sign_date	string	Дата подписания контракта
subject	string	Предмет контракта
amount_rur	number	Сумма контракта
year	number	Год, за который данные

Агрегация по годам внутри региона и ФО

Можно получить данные по региону с раскладкой агрегированных сумм/количеств по годам. Для этого необходимо отправить GET запрос на: region/<код_региона>/, например:

region/77/

Пример ответа:

{
    "admin_centre": null,
    "alt_name": "Москва",
    "budget": null,
    "by_year": {
        "2016": {
            "44": {
                "amount": 1846396332056.31,
                "quantity": 223386,
                "customers": 3690,
                "suppliers": 45804
            },
            "223": {
                "amount": 11389548716576.46,
                "quantity": 270918,
                "customers": 1736,
                "suppliers": 73052
            }
        },
        "2017": {
            "44": {
                "amount": 1867674773998.47,
                "quantity": 255193,
                "customers": 3786,
                "suppliers": 52440
            },
            "223": {
                "amount": 7612771359168.73,
                "quantity": 274325,
                "customers": 1795,
                "suppliers": 68565
            }
        },
        "2018": {
            "44": {
                "amount": 2029965800312.94,
                "quantity": 270000,
                "customers": 3652,
                "suppliers": 50880
            },
            "223": {
                "amount": 8115541304592.02,
                "quantity": 263358,
                "customers": 1850,
                "suppliers": 30679
            }
}

В поле by_year представлена аггрегация данных по годам и по номерам ФЗ.

Аналогичным образом можно получить данные по ФО с раскладкой агрегированных сумм/количеств по годам. Для этого необходимо отправить GET запрос на: fed-district/<код_федерального_округа>/, например:

fed-district/DFO/

Пример ответа:

{
    "admin_centre": "Владивосток",
    "budget": null,
    "by_year": {
        "2016": {
            "44": {
                "amount": 375318804968.63,
                "quantity": 251862,
                "customers": 11704,
                "suppliers": 38265
            },
            "223": {
                "amount": 824836919047.23,
                "quantity": 70338,
                "customers": 1932,
                "suppliers": 24545
            }
        },
        "2017": {
            "44": {
                "amount": 377094372579.79,
                "quantity": 259188,
                "customers": 12288,
                "suppliers": 40095
            },...

Описание данных

Название поля	Тип данных	Значение
admin_centre	string	Административный центр региона/ФО
budget	number/null	Бюджет региона/ФО

Описание данных в поле by_year с разделением по ФЗ

Название поля	Тип данных	Значение
amount	number	Общая сумма контрактов
quantity	number	Количество контрактов
customers	number	Количество заказчиков
suppliers	number	Количество поставщиков