Поставщики

Данные о поставщиках

Вывод данных о подрядчике (поставщике) с указанием номера ИНН поставщика

GET запрос на suppliers/<inn>

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

Название параметра	Значение
apikey	API ключ для запроса

Пример запроса: suppliers/7707083893?apikey=<apikey>

Ответы:

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

{
  "fz": "44",
  "full_name": "Открытое акционерное общество \"Сбербанк России\"",
  "inn": "7707083893",
  "kpp": "783502001",
  "okpo": null,
  "region_code": "77",
  "region_name": "Москва",
  "okopf": {
    "code": "12247",
    "name": "Публичные акционерные общества"
  },
  "address": "191124, Санкт-Петербург, ул.Красного Текстильщика, д.2\n117997, Москва ул.Вавилова, д.19",
  "is_unfair": null,
  "totals": {
    "contracts223_count": 5238,
    "contracts223_sum": 1079898316664.19,
    "contracts44_count": 28656,
    "contracts44_sum": 1034383114504.8,
    "contracts_count": 33894,
    "contracts_sum": 2114281431168.99
  }
}

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

Название поля	Тип данных	Значение
fz	str	Федеральный закон
full_name	str	Полное наименование поставщика
inn	str	ИНН поставщика
kpp	str	КПП поставщика
okpo	str	ОКПО поставщика
region_code	str	Код региона поставщика
region_name	str	Наименование региона поставщика
okopf	dict	Организационно-правовая форма поставщика
address	str	Адрес поставщика
is_unfair	boolean/null	Признак недобросовестного поставщика/ Данные отсутствуют
totals	dict	Агрегированная информация контрактов и сумм

okopf

Название поля	Тип данных	Значение
code	str	Код
name	str	Расшифровка кода

totals

Название поля	Тип данных	Значение
contracts223_count	int	Количество контрактов по 223 ФЗ
contracts223_sum	float	Сумма контрактов по 223 ФЗ
contracts44_count	int	Количество контрактов по 44 ФЗ
contracts44_sum	float	Сумма контрактов по 44 ФЗ
contracts_count	int	Общее количество контрактов
contracts_sum	float	Общая сумма контрактов

Получение данных о подрядчиках с применением желаемых фильтров.

GET запрос на filtered-suppliers/

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

Название параметра	Значение
apikey	API ключ для запроса
sort	Принимает название поля, по которому нужно сортировать (например, ogrn, для сортировки по убыванию передается -ogrn).
page	Порядковый номер страницы результатов (для последующих запросов).
page_size	Число записей на странице результатов, можно указать любое целое число от 1 до 50
inn	ИНН подрядчика
kpp	КПП подрядчика
region_code	Код региона подрядчика
ogrn	ОГРН подрядчика
search	Ключевое слово для поиска подрядчиков, например, «сыр».

Пример запроса: filtered_suppliers?apikey=<apikey>&search=сыр

Ответы:

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

{
  "count": 55,
  "page_size": 20,
  "total_pages": 3,
  "page": 1,
  "data": [
    {
      "actual_address": null,
      "full_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"АМЕТ-СЫРЬЕ\"",
      "inn": "0272015250",
      "is_ip": false,
      "kpp": "027701001",
      "ogrn": "1070272001865",
      "okpo": null,
      "opf_code": "12300",
      "opf_name": "Общества с ограниченной ответственностью",
      "opf_version": "okopf",
      "post_address": null,
      "region_code": "02",
      "region_name": "Республика Башкортостан",
      "short_name": null,
      "contracts223_count": 6,
      "contracts44_count": 0,
      "contracts_count": 6,
      "contracts223_sum": 72320601.1,
      "contracts44_sum": 0,
      "contracts_sum": 72320601.1
    },

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

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

count: на количество записей в ответе установлен лимит в 500. Для того, чтобы получить больше записей в ответе, вы можете дробить запрос на более мелкие части, с помощью фильтров по региону и дате подписания контракта.

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

Название поля	Тип данных	Значение
actual_address	str	Адрес подрядчика
full_name	str	Полное наименование подрядчика
is_ip	boolean	Является ли подрядчик ИП
inn	str	ИНН подрядчика
kpp	str	КПП подрядчика
ogrn	str	ОГРН подрядчика
okpo	str	Код ОКПО подрядчика
opf_code	str	Код ОПФ
opf_name	str	Расшифровка кода ОПФ
opf_version	str	Версия ОПФ
post_address	str	Почтовый адрес подрядчика
region_code	str	Код региона
region_name	str	Наименование региона
short_name	str	Краткое наименование подрядчика
contracts223_count	int	Количество заключенных контрактов по 223 ФЗ
contracts44_count	int	Количество заключенных контрактов по 44 ФЗ
contracts_count	int	Общее количество заключенных контрактов
contracts223_sum	float	Сумма контрактов по 223 ФЗ
contracts44_sum	float	Сумма контрактов по 44 ФЗ
contracts_sum	float	Общая сумма всех контрактов

Топ-500 подрядчиков по убыванию суммы контрактов.

GET запрос на top-suppliers/

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

Название параметра	Значение
apikey	API ключ для запроса
page	Порядковый номер страницы результатов (для последующих запросов).
page_size	Число записей на странице результатов, можно указать любое целое число от 1 до 50

Ответы:

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

{
  "count": 500,
  "page_size": 20,
  "total_pages": 25,
  "page": 1,
  "data": [
    {
      "actual_address": null,
      "full_name": "ГАЗПРОМ ОАО",
      "inn": "7736050003",
      "is_ip": false,
      "kpp": "151541001",
      "ogrn": "1061515009555",
      "okpo": null,
      "opf_code": "47",
      "opf_name": "Акционерное общество открытого типа",
      "opf_version": "kopf",
      "post_address": null,
      "region_code": "15",
      "region_name": "Республика Северная Осетия — Алания",
      "short_name": null,
      "contracts223_count": 951,
      "contracts44_count": 62,
      "contracts_count": 1013,
      "contracts223_sum": 2329580982667.77,
      "contracts44_sum": 72214592.62,
      "contracts_sum": 2329653197260.39
    }

Детальное описание ответа представлено выше.