Для интеграции с вашей информационной системой мы предоставляем API по протоколу RESTful+JSON.
Если у вас уже готовое приложение, которое способствует развитию открытых данных, то вы можете оставить заявку для получения бесплатного ключа. Для этого вам необходимо:
Если API нужно для личного или внутрикорпоративного использования, то вам нужно купить нужное вам количество запросов. Для этого вам необходимо:
В случае одобрения вашей заявки вам будет предоставлен ключ доступа. Данный ключ доступа необходимо указывать в заголовке X-ACCESS-KEY при каждом запросе к API.
С одного ключа доступа можно отправлять не более 3-х запросов в секунду.
Несоблюдение ограничений приведёт к аннулированию ключа и невозможности использовать API.
Обязательно вступайте в наши группы Вконтакте и Facebook, чтобы быть в курсе обновлений API, изменения в ограничениях, а также оставлять свои предложения. Хорошую платформу можно сделать только общими усилиями.
Поиск компании по ИНН, ОГРН или по названию. С помощью этой команды можно получить идентификатор нужной компании и далее с помощью следующих команд получить детальную информацию.
Параметр | Тип | Описание |
---|---|---|
огрн | Строка | Если задан ОГРН, то остальные параметры игнорируются |
инн | Строка | Если задан ИНН, то будут выведены все компании с подходящим ИНН |
кпп | Строка | Дополняет поиск по ИНН. Если задан параметр ИНН, то КПП будет добавлен к условию. Если ИНН не задан, то параметр будет проигнорирован. |
наименование | Строка | Поиск по наименованию компании. Результат не более 50 строк. Чтобы посмотреть следующие результаты, используйте параметр "стр" |
стр | Число | По умолчанию = 1. Используется только вместе с параметром "наименование" |
Пример
/интеграция/компании/?наименование=СТРОЙПРОЕКТ&стр=2
/интеграция/компании/?инн=7736002426
[{
"id"Внутренний идентификатор : "7030",
"name"Полное наименование юридического лица : "АКЦИОНЕРНОЕ ОБЩЕСТВО "ИНСТИТУТ "СТРОЙПРОЕКТ"",
"shortName"Сокращённое наименование юридического лица : "АО "ИНСТИТУТ "СТРОЙПРОЕКТ"",
"ogrn"ОРГН (Основной государственный регистрационный номер) : "1027810258673",
"ogrnDate"Дата выдачи ОРГН, она же дата регистрации юридического лица : "2002-11-12T00:00:00.000",
"inn"ИНН (Идентификационный номер налогоплательщика) : "7826688390",
"kpp"КПП (Код причины постановки на учёт) : "781001001"
}]
Возвращает данные из ЕГРЮЛ о компании с идентификатором {id}
Пример: /интеграция/компании/7030/
Возвращает объект следующего типа:{
"id"Внутренний идентификатор : "7030",
"name"Полное наименование юридического лица : "АКЦИОНЕРНОЕ ОБЩЕСТВО "ИНСТИТУТ "СТРОЙПРОЕКТ"",
"shortName"Сокращённое наименование юридического лица : "АО "ИНСТИТУТ "СТРОЙПРОЕКТ"",
"ogrn"ОРГН (Основной государственный регистрационный номер) : "1027810258673",
"ogrnDate"Дата выдачи ОРГН, она же дата регистрации юридического лица : "2002-11-12T00:00:00.000",
"inn"ИНН (Идентификационный номер налогоплательщика) : "7826688390",
"kpp"КПП (Код причины постановки на учёт) : "781001001",
"okopf"ОКОПФ (Общероссийский классификатор организационно-правовых форм) : {
"id"Внутренний идентификатор значения справочника : "165",
"code"Код значения справочника (натуральный ключ) : "12267",
"name"Наимеование значения справочника : "Непубличные акционерные общества",
"fullName"Полное наименование значения справочника : "12267 Непубличные акционерные общества",
"parent"Родительское значение справочника : {
"id"внутренний идентификатор значения справочника : "165"
}
},
"lastUpdateDate"Дата последнего обновления записи из базы ЕГРЮЛ : "2015-12-09T00:00:00.000",
"authorizedCapital"Данные по уставному капиталу : {
"type"Тип уставного капитала : "УСТАВНЫЙ КАПИТАЛ",
"value"Сумма уставного капитала : "33200.00"
},
"address"Адрес юридического лица в соответствии с ФИАС : {
"region"Субъект Федерации : {
"id"Внутренний идентификатор адресного объекта : "1208752",
"name"Официальное наименование : "Санкт-Петербург",
"typeName"Полное наименование типа : "Город",
"typeShortName"Сокращённое наименование типа : "г",
"fullName"Полное наименование вместе с типом : "Санкт-Петербург Город",
"aoid"Уникальный идентификатор записи. Ключевое поле : "aad1469e-54ff-4605-af4f-f016c75b84d2",
"guid"Глобальный уникальный идентификатор адресного объекта : "c2deb16a-0330-4f05-821f-1d09c93331e6",
"regionCode"Код региона : "78",
"autoCode"Код автономии : "0",
"areaCode"Код района : "000",
"cityCode"Код города : "000",
"ctarCode"Код внутригородского района : "000",
"placeCode"Код населенного пункта : "000",
"streetCode"Код улицы : "0000",
"extrCode"Код дополнительного адресообразующего элемента : "0000",
"sextCode"Код подчиненного дополнительного адресообразующего элемента : "000",
"kladrCode"Код адресного объекта из КЛАДР 4.0 одной строкой : "7800000000000",
"postalCode"Почтовый индекс : "190000",
"level"Уровень адресного объекта : "1",
"okato"ОКАТО : "40000000000",
"live"Признак действующего адресного объекта : "true",
"companyCount"Количество юридических лиц, зарегистрированных в данном адресном объекте : "791135"
},
"auto"Автономия. Структура аналогична region. Может отсутствовать. : {...},
"area"Район. Структура аналогична region. Может отсутствовать. : {...},
"city"Город. Структура аналогична region. Может отсутствовать. : {...},
"cityArea"Внутригородской район. Структура аналогична region. Может отсутствовать. : {...},
"place"Населённый пункт. Структура аналогична region. Может отсутствовать. : {...},
"street"Улица. Структура аналогична region. Может отсутствовать. : {...},
"ext"Дополнительный адресообразующеий элемент. Структура аналогична region. Может отсутствовать. : {...},
"sext"Подчинённый дополнительный адресообразующеий элемент. Структура аналогична region. Может отсутствовать. : {...},
"house"Номер дома : "13",
"building"Строение : "2",
"flat"Номер офиса или квартиры : "ЛИТА",
"postalIndex"Почтовый индекс : "196158",
"fullHouseAddress"Полный адрес дома : "196158,Санкт-Петербург Город,Дунайский Проспект,13 2"
},
"mainOkved1"Основной ОКВЭД по справочнику версии 1.1 : {
"id"Внутренний идентификатор значения справочника : "1632",
"code"Код значения справочника (натуральный ключ) : "74.20.13",
"name"Наимеование значения справочника : "Проектирование, связанное со строительством инженерных сооружений, включая гидротехнические сооружения; проектирование движения транспортных потоков",
"fullName"Полное наименование значения справочника : "74.20.13 Проектирование, связанное со строительством инженерных сооружений, включая гидротехнические сооружения; проектирование движения транспортных потоков",
"parent"Родительское значение справочника : {
"id"Внутренний идентификатор значения справочника : "1629"
},
},
"okved1"Список дополнительных ОКВЭД по справочнику версии 1.1 : [ ],
"pfrRegistration"Информация о регистрации в ПФР : {
"registrationDate"Дата регистрации : "2003-11-12T00:00:00.000",
"number"Регистрационный номер : "088009042191",
"pfr"Сведения об учреждении ПФР : {
"id"Внутренний идентификатор значения справочника : "165",
"code"Код значения справочника (натуральный ключ) : "088009",
"name"Наимеование значения справочника : "ГОСУДАРСТВЕННОЕ УЧРЕЖДЕНИЕ УПРАВЛЕНИЕ ПЕНСИОННОГО ФОНДА РФ ПО МОСКОВСКОМУ РАЙОНУ САНКТ-ПЕТЕРБУРГА",
"fullName"Полное наименование значения справочника : "088009 ГОСУДАРСТВЕННОЕ УЧРЕЖДЕНИЕ УПРАВЛЕНИЕ ПЕНСИОННОГО ФОНДА РФ ПО МОСКОВСКОМУ РАЙОНУ САНКТ-ПЕТЕРБУРГА"
},
},
"fssRegistration"Информация о регистрации в ФСС : {
"registrationDate"Дата регистрации : "2001-04-11T00:00:00.000",
"number"Регистрационный номер : "781009076778121",
"pfr"Сведения об учреждении ФСС : {
"id"Внутренний идентификатор значения справочника : "21",
"code"Код значения справочника (натуральный ключ) : "7812",
"name"Наимеование значения справочника : "ФИЛИАЛ №12 САНКТ-ПЕТЕРБУРГСКОГО РЕГИОНАЛЬНОГО ОТДЕЛЕНИЯ ФОНДА СОЦИАЛЬНОГО СТРАХОВАНИЯ РОССИЙСКОЙ ФЕДЕРАЦИИ",
"fullName"Полное наименование значения справочника : "7812 ФИЛИАЛ №12 САНКТ-ПЕТЕРБУРГСКОГО РЕГИОНАЛЬНОГО ОТДЕЛЕНИЯ ФОНДА СОЦИАЛЬНОГО СТРАХОВАНИЯ РОССИЙСКОЙ ФЕДЕРАЦИИ"
},
}
}
Возвращает данные об учредителях компании с идентификатором {id}
Пример: /интеграция/компании/7030/учредители/
Возвращает объект следующего типа:[{
"personOwner"Сведения об учредителе физическом лице : {
"id"Внутренний идентификатор человека : "2191023",
"firstName"Имя : "АЛЕКСЕЙ",
"middleName"Отчество : "АЛЕКСАНДРОВИЧ",
"surName"Фамилия : "ЖУРБИН",
"inn"ИНН человека : "781010102204"
},
"price"Доля в уставном капитале : "8100.00"
},
... ,
{
"companyOwner"Сведения об учредителе юридическом лице : {
"id"Внутренний идентификатор юридического лица : "8360643",
"name"Полное наименование юридического лица : "ОТКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО ПО ПРОЕКТИРОВАНИЮ СТРОИТЕЛЬСТВА МОСТОВ "ИНСТИТУТ "ГИПРОСТРОЙМОСТ"",
"shortName"Сокращённое наименование юридического лица : "ОТКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО ПО ПРОЕКТИРОВАНИЮ СТРОИТЕЛЬСТВА МОСТОВ "ИНСТИТУТ "ГИПРОСТРОЙМОСТ"",
},
"price"Доля в уставном капитале : "1900.00"
}]
Возвращает данные о сотрудниках, умеющих право подписи в компании с идентификатором {id}
Пример: /интеграция/компании/32357/сотрудники/
Возвращает объект следующего типа:[
{
"person"Сведения о сотруднике : {
"id"Внутренний идентификатор человека : "49758",
"firstName"Имя : "ОКСАНА",
"middleName"Отчество : "ПЕТРОВНА",
"surName"Фамилия : "САХЬЯНОВА",
"inn"ИНН человека : "032307402383"
}
,"post"Должность по справочнику : {
"id"Внутренний идентификатор значения справочника : "3",
"code"Код значения справочника (натуральный ключ) : "02",
"name"Наимеование значения справочника : "РУКОВОДИТЕЛЬ ЮРИДИЧЕСКОГО ЛИЦА",
"fullName"Полное наименование значения справочника : "02 РУКОВОДИТЕЛЬ ЮРИДИЧЕСКОГО ЛИЦА"
},
"postName"Наименование должности в компании : "ПРЕЗИДЕНТ"
}
,{...}
]
Возвращает других компаниях, в которых данная компания является соучредителем
Пример: /интеграция/компании/8360643/зависимые/
Возвращает список объект следующего типа:[{
"id"Внутренний идентификатор : "7030",
"name"Полное наименование юридического лица : "АКЦИОНЕРНОЕ ОБЩЕСТВО "ИНСТИТУТ "СТРОЙПРОЕКТ"",
"shortName"Сокращённое наименование юридического лица : "АО "ИНСТИТУТ "СТРОЙПРОЕКТ"",
"ogrn"ОРГН (Основной государственный регистрационный номер) : "1027810258673",
"ogrnDate"Дата выдачи ОРГН, она же дата регистрации юридического лица : "2002-11-12T00:00:00.000",
"inn"ИНН (Идентификационный номер налогоплательщика) : "7826688390",
"kpp"КПП (Код причины постановки на учёт) : "781001001"
}]
Возвращает список известных представительств компании
Пример: /интеграция/компании/4527642/представительства/
Возвращает список объект следующего типа:[
{
"company"Сведения о родительской компании : {
"id"Внутренний идентификатор компании : "4527642",
},
"name"Наименование подразделения : "ФИЛИАЛ ОБЩЕСТВА С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ТОРГОВО-ПРОМЫШЛЕННАЯ КОМПАНИЯ "ПЕНТАН" В Г.ВОЛГОГРАДЕ",
"address"Адрес юридического лица в соответствии с ФИАС : {
...
},
"kpp"КПП (Код причины постановки на учёт) : "781001001",
"fns_date"Дата постановки на налоговой учёт : "2002-11-12T00:00:00.000",
"fns"Служба, поставившая подразделение на налоговой учёт : {
"id"Внутренний идентификатор значения справочника : "8",
"code"Код значения справочника (натуральный ключ) : "3454",
"name"Наимеование значения справочника : "Межрайонная инспекция Федеральной налоговой службы №4 по Волгоградской области",
"fullName"Полное наименование значения справочника : "3454 Межрайонная инспекция Федеральной налоговой службы №4 по Волгоградской области"
}
}
,{...}
]
Возвращает список известных филиалов компании
Пример: /интеграция/компании/4527642/филиалы/
Возвращает список объект следующего типа:[
{
"company"Сведения о родительской компании : {
"id"Внутренний идентификатор компании : "4527642",
},
"name"Наименование подразделения : "ФИЛИАЛ ОБЩЕСТВА С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ТОРГОВО-ПРОМЫШЛЕННАЯ КОМПАНИЯ "ПЕНТАН" В Г.ВОЛГОГРАДЕ",
"address"Адрес юридического лица в соответствии с ФИАС : {
...
},
"kpp"КПП (Код причины постановки на учёт) : "781001001",
"fns_date"Дата постановки на налоговой учёт : "2002-11-12T00:00:00.000",
"fns"Служба, поставившая подразделение на налоговой учёт : {
"id"Внутренний идентификатор значения справочника : "8",
"code"Код значения справочника (натуральный ключ) : "3454",
"name"Наимеование значения справочника : "Межрайонная инспекция Федеральной налоговой службы №4 по Волгоградской области",
"fullName"Полное наименование значения справочника : "3454 Межрайонная инспекция Федеральной налоговой службы №4 по Волгоградской области"
}
}
,{...}
]
Возвращает список лицензий компании
Пример: /интеграция/компании/350/лицензии/
Возвращает список объект следующего типа:[
{
"company"Сведения о компании : {
"id"Внутренний идентификатор компании : "350",
},
"number"Номер : "036-03348-010000",
"date"Дата лицензии : "2002-11-12T00:00:00.000",
"startDate"Дата начала действия : "2002-11-12T00:00:00.000",
"endDate"Дата окончания действия : " ",
"activity"Список виды деятельности : "[ "Дилерская деятельность" ]",
"licensor"Лицензирующий орган : "Центральный банк Российской Федерации",
"location"Список мест деятельности : "[ "г. Самара" ]",
"suspendDate"Дата приостановки : " ",
"suspender"Приостановивший орган : " ",
}
,{...}
]
Возвращает бухгалтерскую отчёность компании
Пример: /интеграция/компании/8/финансы/
Возвращает список объект следующего типа:[{
"company"Компания : {
"id"Внутренний идентификатор : "8"
},
"year"Год : "2016",
"moneyCode"Код единицы измерения (384 - тыс.руб, 385 - млн.руб) : "384",
"f11103"Строка с кодом 11103: Нематериальные активы на конец отчетного года : "2657",
"f11104"Строка с кодом 11104: Нематериальные активы на конец предыдущего года : "3548",
....
"f64003"Строка с кодом 64003: Остаток средств на конец отчетного года : "6547",
}]
Состав полей бухгалтерской отчётности с кодами и описанием определён в приложении к приказу Министерства
финансов
РФ от 02.07.2010 № 66н. Также описание вы можете прочитать на любой странице с отчётностью на этом сайте.
Поиск человека по ФИО или ИНН
Параметр | Тип | Описание |
---|---|---|
фамилия | Строка | Фамилия человека, которого ищем |
имя | Строка | Имя человека, которого ищем |
отчество | Строка | Отчество человека, которого ищем |
инн | Строка | ИНН человека. Если этот параметр указан, то другие игнорируются |
стр | Число | По умолчанию = 1 |
Пример: /интеграция/люди/?фамилия=ЖУРБИН&имя=АЛЕКСЕЙ
Возвращает список объект следующего типа:{
"id"Внутренний идентификатор человека : "2191023",
"firstName"Имя : "АЛЕКСЕЙ",
"middleName"Отчество : "АЛЕКСАНДРОВИЧ",
"surName"Фамилия : "ЖУРБИН",
"inn"ИНН человека : "781010102204"
}
Возвращает информацию о человеке с указанным идентификатором
Пример: /интеграция/люди/2191023/
Возвращает объект следующего типа:{
"id"Внутренний идентификатор человека : "2191023",
"firstName"Имя : "АЛЕКСЕЙ",
"middleName"Отчество : "АЛЕКСАНДРОВИЧ",
"surName"Фамилия : "ЖУРБИН",
"inn"ИНН человека : "781010102204"
}
Возвращает информацию должностях, которые занимает указанный человек
Пример: /интеграция/люди/2191023/должности/
Возвращает список объект следующего типа:[
{
"person"Сведения о сотруднике : {
"id"Внутренний идентификатор человека : "49758",
"firstName"Имя : "ОКСАНА",
"middleName"Отчество : "ПЕТРОВНА",
"surName"Фамилия : "САХЬЯНОВА",
"inn"ИНН человека : "032307402383"
}
,"post"Должность по справочнику : {
"id"Внутренний идентификатор значения справочника : "3",
"code"Код значения справочника (натуральный ключ) : "02",
"name"Наимеование значения справочника : "РУКОВОДИТЕЛЬ ЮРИДИЧЕСКОГО ЛИЦА",
"fullName"Полное наименование значения справочника : "02 РУКОВОДИТЕЛЬ ЮРИДИЧЕСКОГО ЛИЦА"
},
"postName"Наименование должности в компании : "ПРЕЗИДЕНТ"
}
,{...}
]
Возвращает информацию о компаниях, в которых данный человек является учредителем
Пример: /интеграция/люди/2191023/компании/
Возвращает список объект следующего типа:[{
"id"Внутренний идентификатор : "7030",
"name"Полное наименование юридического лица : "АКЦИОНЕРНОЕ ОБЩЕСТВО "ИНСТИТУТ "СТРОЙПРОЕКТ"",
"shortName"Сокращённое наименование юридического лица : "АО "ИНСТИТУТ "СТРОЙПРОЕКТ"",
"ogrn"ОРГН (Основной государственный регистрационный номер) : "1027810258673",
"ogrnDate"Дата выдачи ОРГН, она же дата регистрации юридического лица : "2002-11-12T00:00:00.000",
"inn"ИНН (Идентификационный номер налогоплательщика) : "7826688390",
"kpp"КПП (Код причины постановки на учёт) : "781001001"
}]
Поиск индивидуальных предпринимателей
Параметр | Тип | Описание |
---|---|---|
человек | число | Идентификатор человека, для которого ищем данные по ИП. Если параметр задан, то другие параметры игноруются. |
огрнип | Строка | Если задан ОГРНИП, то следующие параметры игнорируются |
инн | Строка | ИНН человека, для котого ищем записи ИП |
Пример
/интеграция/ип/?человек=7528374
/интеграция/ип/?огрнип=314272211800010
{
"id"Внутренний идентификатор : "1",
"ogrn"ОГРНИП : "314272211800010",
"ogrnDate"Дата регистрации : "2011-12-23T00:00:00.000",
"personOwner"Сведения о физическом лице : {
"id"Внутренний идентификатор человека : "2191023",
"firstName"Имя : "ИЛЬЯ",
"middleName"Отчество : "АЛЕКСАНДРОВИЧ",
"surName"Фамилия : "НИКУЛИН",
"inn"ИНН человека : "272508402480"
},
"lastUpdateDate"Дата последнего обновления записи из базы ЕГРИП : "2015-12-09T00:00:00.000",
"mainOkved1"Основной ОКВЭД по справочнику версии 1.1 : {
"id"Внутренний идентификатор значения справочника : "1632",
"code"Код значения справочника (натуральный ключ) : "74.20.13",
"name"Наимеование значения справочника : "Проектирование, связанное со строительством инженерных сооружений, включая гидротехнические сооружения; проектирование движения транспортных потоков",
"fullName"Полное наименование значения справочника : "74.20.13 Проектирование, связанное со строительством инженерных сооружений, включая гидротехнические сооружения; проектирование движения транспортных потоков",
"parent"Родительское значение справочника : {
"id"Внутренний идентификатор значения справочника : "1629"
},
},
"okved1"Список дополнительных ОКВЭД по справочнику версии 1.1 : [ ]
}
Возвращает информаицю по текущему состоянию вашего лицевого счёта
Внимание! Количество оставшихся запросов может быть не точным в связи с тем, что часть отправленных запросов находится в кеше и пока ещё не сохранена в базе данных
Возвращает объект следующего типа:{
"authorizationKey"Ключ доступа к API : "j2egid-0d-saikgadsfhghadf8g8fd",
"requestsLeft"Осталось оплаченных запросов : "10000",
"dueDate"Дата окончания оплаченных запросов : "2018-11-12T00:00:00.000"
}