↑ Все API

API: организация по ИНН или ОГРН

Находит компанию или ИП по ИНН или ОГРН. Возвращает все доступные сведения о компании, в отличие от метода suggest, который возвращает только базовые поля.

Как вызвать

Чтобы вызвать метод, и подтвердите почту.

Пример запроса:

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party
            
            
{ "query": "7707083893" }

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

Параметры запроса

НазваниеТипОбяз.?По умолч.Описание
querystringИНН или ОГРН
countnumber10Количество результатов (максимум — 300)
kppstring КПП для поиска по филиалам, см. пример
branch_typestring Головная организация (MAIN) или филиал (BRANCH), см. пример
typestring Юрлицо (LEGAL) или индивидуальный предприниматель (INDIVIDUAL), см. пример
statusarray [string] Ограничение по статусу организации

Головные организации и филиалы

Если у компании есть филиалы, запрос вернёт несколько объектов. Если нужна только головная организация, укажите дополнительный параметр branch_type:

{
    "query": "7707083893",
    "branch_type": "MAIN"
}

Чтобы найти конкретный филиал, укажите дополнительный параметр kpp:

{
    "query": "7707083893",
    "kpp": "540602001"
}

К сожалению, для 25% компаний налоговая служба пока не сообщает КПП филиалов. Такие филиалы с помощью данного метода найти не получится.

Юрлица и индивидуальные предприниматели

Чтобы искать только среди юрлиц, либо только среди индивидуальных предпринимателей, укажите параметр type:

# Юрлица
{
    "query": "7707083893",
    "type": "LEGAL"
}

# Индивидуальные предприниматели
{
    "query": "784806113663",
    "type": "INDIVIDUAL"
}

Что в ответе

Пример ответа
{
  "suggestions": [
    {
      "value": "ООО \"МОТОРИКА\"",
      "unrestricted_value": "ООО \"МОТОРИКА\"",
      "data": {
        "kpp": "772301001",
        "kpp_largest": null,
        "capital": {
          "type": "УСТАВНЫЙ КАПИТАЛ",
          "value": 64683.7
        },
        "invalid": null,
        "management": {
          "name": "Давидюк Андрей Павлович",
          "post": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
          "start_date": 1669237200000,
          "disqualified": null
        },
        "founders": [
          {
            "ogrn": "1232500002140",
            "inn": "2540274313",
            "name": "МЕЖДУНАРОДНАЯ КОМПАНИЯ ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ХОМО АУКТУС\"",
            "hid": "162fda77a319e6654cb77fc9e70593f07e73c4a447051c20a742978dc546d2f1",
            "type": "LEGAL",
            "share": {
              "value": 100,
              "type": "PERCENT"
            },
            "invalidity": null,
            "start_date": 1676840400000
          }
        ],
        "managers": [
          {
            "inn": "782617173381",
            "fio": {
              "surname": "Давидюк",
              "name": "Андрей",
              "patronymic": "Павлович",
              "gender": "MALE",
              "source": "ДАВИДЮК АНДРЕЙ ПАВЛОВИЧ",
              "qc": null
            },
            "post": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
            "hid": "88fe9c0a7f8d26948d2e5305b442a83c367f1029b9420fd720d196244f1d9ec3",
            "type": "EMPLOYEE",
            "invalidity": null,
            "start_date": 1669237200000
          }
        ],
        "predecessors": null,
        "successors": null,
        "branch_type": "MAIN",
        "branch_count": 0,
        "source": null,
        "qc": null,
        "hid": "baf582914d601bc5246e881b07dfa6e336091a3857bebc3bf389aa0b4073223c",
        "type": "LEGAL",
        "state": {
          "status": "ACTIVE",
          "code": null,
          "actuality_date": 1732060800000,
          "registration_date": 1423094400000,
          "liquidation_date": null
        },
        "opf": {
          "type": "2014",
          "code": "12300",
          "full": "Общество с ограниченной ответственностью",
          "short": "ООО"
        },
        "name": {
          "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"МОТОРИКА\"",
          "short_with_opf": "ООО \"МОТОРИКА\"",
          "latin": null,
          "full": "МОТОРИКА",
          "short": "МОТОРИКА"
        },
        "inn": "7719402047",
        "ogrn": "1157746078984",
        "okpo": "27539247",
        "okato": "45290582000",
        "oktmo": "45393000000",
        "okogu": "4210014",
        "okfs": "16",
        "okved": "72.19",
        "okveds": [
          {
            "main": true,
            "type": "2014",
            "code": "72.19",
            "name": "Научные исследования и разработки в области естественных и технических наук прочие"
          },
          {
            "main": false,
            "type": "2014",
            "code": "24.34",
            "name": "Производство проволоки методом холодного волочения"
          },
          {
            "main": false,
            "type": "2014",
            "code": "24.41",
            "name": "Производство драгоценных металлов"
          },
          {
            "main": false,
            "type": "2014",
            "code": "25.61",
            "name": "Обработка металлов и нанесение покрытий на металлы"
          },
          {
            "main": false,
            "type": "2014",
            "code": "26.60.4",
            "name": "Производство инструмента, оборудования и приспособлений, применяемых в медицинских целях"
          },
          {
            "main": false,
            "type": "2014",
            "code": "26.60.5",
            "name": "Производство диагностического и терапевтического оборудования, применяемого в медицинских целях"
          },
          {
            "main": false,
            "type": "2014",
            "code": "26.60.9",
            "name": "Производство прочего оборудования, применяемого в медицинских целях"
          },
          {
            "main": false,
            "type": "2014",
            "code": "32.12.1",
            "name": "Производство изделий технического назначения из драгоценных металлов"
          },
          {
            "main": false,
            "type": "2014",
            "code": "32.50",
            "name": "Производство медицинских инструментов и оборудования"
          },
          {
            "main": false,
            "type": "2014",
            "code": "32.99.9",
            "name": "Производство прочих изделий, не включенных в другие группировки"
          },
          {
            "main": false,
            "type": "2014",
            "code": "38.32.2",
            "name": "Обработка (переработка) лома и отходов драгоценных металлов"
          }
        ],
        "authorities": {
          "fts_registration": {
            "type": "FEDERAL_TAX_SERVICE",
            "code": "7746",
            "name": "Межрайонная инспекция Федеральной налоговой службы № 46 по г. Москве",
            "address": "125373, г.Москва, Походный проезд, домовладение 3, стр.2"
          },
          "fts_report": {
            "type": "FEDERAL_TAX_SERVICE",
            "code": "7723",
            "name": "Инспекция Федеральной налоговой службы № 23 по г.Москве",
            "address": null
          },
          "pf": {
            "type": "PENSION_FUND",
            "code": "087505",
            "name": "Отделение Фонда пенсионного и социального страхования Российской Федерации по г. Москве и Московской области",
            "address": null
          },
          "sif": {
            "type": "SOCIAL_INSURANCE_FUND",
            "code": "7738",
            "name": "Отделение Фонда пенсионного и социального страхования Российской Федерации по г. Москве и Московской области",
            "address": null
          }
        },
        "documents": {
          "fts_registration": {
            "type": "FTS_REGISTRATION",
            "series": "77",
            "number": "016942308",
            "issue_date": 1423094400000,
            "issue_authority": "7746"
          },
          "fts_report": {
            "type": "FTS_REPORT",
            "series": null,
            "number": null,
            "issue_date": 1705276800000,
            "issue_authority": "7723"
          },
          "pf_registration": {
            "type": "PF_REGISTRATION",
            "series": null,
            "number": "087505029773",
            "issue_date": 1705449600000,
            "issue_authority": "087505"
          },
          "sif_registration": {
            "type": "SIF_REGISTRATION",
            "series": null,
            "number": "772406613777381",
            "issue_date": 1512432000000,
            "issue_authority": "7738"
          },
          "smb": {
            "category": "SMALL",
            "type": "SMB",
            "series": null,
            "number": null,
            "issue_date": 1691625600000,
            "issue_authority": null
          }
        },
        "licenses": null,
        "finance": {
          "tax_system": null,
          "income": 1895091000,
          "expense": 1247123000,
          "revenue": 1858707000,
          "debt": null,
          "penalty": null,
          "year": 2023
        },
        "address": {
          "value": "г Москва, Волгоградский пр-кт, д 42 к 5, помещ 1Н",
          "unrestricted_value": "109316, г Москва, р-н Печатники, Волгоградский пр-кт, д 42 к 5, помещ 1Н",
          "invalidity": null,
          "data": {
            "postal_code": "109316",
            "country": "Россия",
            "country_iso_code": "RU",
            "federal_district": "Центральный",
            "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
            "region_kladr_id": "7700000000000",
            "region_iso_code": "RU-MOW",
            "region_with_type": "г Москва",
            "region_type": "г",
            "region_type_full": "город",
            "region": "Москва",
            "area_fias_id": null,
            "area_kladr_id": null,
            "area_with_type": null,
            "area_type": null,
            "area_type_full": null,
            "area": null,
            "city_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
            "city_kladr_id": "7700000000000",
            "city_with_type": "г Москва",
            "city_type": "г",
            "city_type_full": "город",
            "city": "Москва",
            "city_area": "Юго-восточный",
            "city_district_fias_id": null,
            "city_district_kladr_id": null,
            "city_district_with_type": "р-н Печатники",
            "city_district_type": "р-н",
            "city_district_type_full": "район",
            "city_district": "Печатники",
            "settlement_fias_id": null,
            "settlement_kladr_id": null,
            "settlement_with_type": null,
            "settlement_type": null,
            "settlement_type_full": null,
            "settlement": null,
            "street_fias_id": "3fbbba41-86cb-4779-9631-e96dd73f536a",
            "street_kladr_id": "77000000000001300",
            "street_with_type": "Волгоградский пр-кт",
            "street_type": "пр-кт",
            "street_type_full": "проспект",
            "street": "Волгоградский",
            "stead_fias_id": null,
            "stead_cadnum": null,
            "stead_type": null,
            "stead_type_full": null,
            "stead": null,
            "house_fias_id": "7ca4e0cb-83c6-4dad-ac90-9207a90cba02",
            "house_kladr_id": "7700000000000130276",
            "house_cadnum": "77:04:0003004:1088",
            "house_flat_count": null,
            "house_type": "д",
            "house_type_full": "дом",
            "house": "42",
            "block_type": "к",
            "block_type_full": "корпус",
            "block": "5",
            "entrance": null,
            "floor": null,
            "flat_fias_id": null,
            "flat_cadnum": null,
            "flat_type": "помещ",
            "flat_type_full": "помещение",
            "flat": "1Н",
            "flat_area": "-1",
            "square_meter_price": "-1",
            "flat_price": null,
            "room_fias_id": null,
            "room_cadnum": null,
            "room_type": null,
            "room_type_full": null,
            "room": null,
            "postal_box": null,
            "fias_id": "7ca4e0cb-83c6-4dad-ac90-9207a90cba02",
            "fias_code": "77000000000000000130276",
            "fias_level": "8",
            "fias_actuality_state": "0",
            "kladr_id": "7700000000000130276",
            "geoname_id": "524901",
            "capital_marker": "0",
            "okato": "45290582000",
            "oktmo": "45393000",
            "tax_office": "7723",
            "tax_office_legal": "7723",
            "timezone": "UTC+3",
            "geo_lat": "55.708875",
            "geo_lon": "37.721055",
            "beltway_hit": "IN_MKAD",
            "beltway_distance": null,
            "metro": [
              {
                "name": "Текстильщики",
                "line": "Большая кольцевая линия",
                "distance": 0.5
              },
              {
                "name": "Текстильщики",
                "line": "Курско-Рижский",
                "distance": 0.6
              },
              {
                "name": "Текстильщики",
                "line": "Таганско-Краснопресненская",
                "distance": 0.7
              }
            ],
            "divisions": null,
            "qc_geo": "0",
            "qc_complete": null,
            "qc_house": null,
            "history_values": null,
            "unparsed_parts": null,
            "source": "109316, Г.МОСКВА, ВН.ТЕР.Г. МУНИЦИПАЛЬНЫЙ ОКРУГ ПЕЧАТНИКИ, ПР-КТ ВОЛГОГРАДСКИЙ, Д. 42, К. 5, ПОМЕЩ. 1Н",
            "qc": "0"
          }
        },
        "phones": [
          {
            "value": "+7 911 2410309",
            "unrestricted_value": "+7 911 2410309",
            "data": {
              "contact": null,
              "source": "+7 911 241 0309",
              "qc": null,
              "type": "Мобильный",
              "number": "2410309",
              "extension": null,
              "provider": "ПАО \"Мобильные ТелеСистемы\"",
              "country": null,
              "region": "Санкт-Петербург и Ленинградская область",
              "city": null,
              "timezone": "UTC+3",
              "country_code": "7",
              "city_code": "911",
              "qc_conflict": null
            }
          }
        ],
        "emails": [
          {
            "value": "DAP@MOTORICA.ORG",
            "unrestricted_value": "DAP@MOTORICA.ORG",
            "data": {
              "local": "DAP",
              "domain": "MOTORICA.ORG",
              "type": null,
              "source": "DAP@MOTORICA.ORG",
              "qc": null
            }
          }
        ],
        "ogrn_date": 1423094400000,
        "okved_type": "2014",
        "employee_count": 111
      }
    }
  ]
}

Все тарифы

НазваниеОписание
valueНаименование компании
unrestricted_value= value
data.innИНН
data.kppКПП
data.ogrnОГРН
data.ogrn_dateДата выдачи ОГРН
data.hidВнутренний идентификатор в Дадате
data.type Тип организации
  LEGAL      — юридическое лицо
  INDIVIDUAL — индивидуальный предприниматель
data.nameНаименование
└ full_with_opf— полное наименование
└ short_with_opf— краткое наименование
└ latin — не заполняется
└ full — полное наименование без ОПФ
генерируется на основе full_with_opf, может содержать ошибки
└ short — краткое наименование без ОПФ
генерируется на основе short_with_opf, может содержать ошибки
data.fioФИО индивидуального предпринимателя
└ surname— фамилия
└ name— имя
└ patronymic— отчество
└ gender не заполняется
└ source не заполняется
└ qc не заполняется
Коды статистики (только для действующих головных организаций и ИП):
data.okatoКод ОКАТО
data.oktmoКод ОКТМО
data.okpoКод ОКПО
data.okoguКод ОКОГУ
data.okfsКод ОКФС
data.okvedКод ОКВЭД
data.okved_typeВерсия справочника ОКВЭД (2001 или 2014)
data.opfОрганизационно-правовая форма
└ code— код ОКОПФ
└ full— полное название ОПФ
└ short— краткое название ОПФ
└ type— версия справочника ОКОПФ (99, 2012 или 2014)
data.managementРуководитель
└ name— ФИО руководителя
└ post— должность руководителя
└ start_date— дата вступления в должность руководителя
data.branch_countКоличество филиалов
data.branch_type Тип подразделения
  MAIN   — головная организация
  BRANCH — филиал
data.addressАдрес
└ value — адрес одной строкой:
  • адрес организации для юридических лиц;
  • город проживания для индивидуальных предпринимателей.
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ unrestricted_value — адрес одной строкой (полный, с индексом)
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ data— гранулярный адрес
└ data.source— адрес одной строкой как в ЕГРЮЛ
└ data.qc — код проверки адреса
  0        — адрес распознан уверенно
  1 или 3  — требуется ручная проверка
data.stateСостояние
└ actuality_date— дата последних изменений
└ registration_date— дата регистрации
└ liquidation_date— дата ликвидации
└ status — статус организации
  ACTIVE       — действующая
  LIQUIDATING  — ликвидируется
  LIQUIDATED   — ликвидирована
  BANKRUPT     — банкротство
  REORGANIZING — в процессе присоединения к другому
                 юрлицу, с последующей ликвидацией
└ codeдетальный статус

Тарифы «Расширенный» и «Максимальный»

Название Описание
data.employee_countСреднесписочная численность работников
data.finance.tax_system Система налогообложения
  AUSN      — автоматизированная упрощенная система
              налогообложения (АУСН)
  ESHN      — единый сельскохозяйственный налог (ЕСХН)
  SRP       — система налогообложения при выполнении
              соглашений о разделе продукции (СРП)
  USN       — упрощенная система налогообложения (УСН)
data.okvedКод ОКВЭД
data.okveds[ ]Коды ОКВЭД дополнительных видов деятельности
└ main— основной или нет (true / false)
└ type— версия справочника ОКВЭД (2001 или 2014)
└ code— код по справочнику
└ name— наименование по справочнику
data.authoritiesСведения о налоговой, ПФР и ФСС
data.authorities.fts_registrationИФНС регистрации
└ type— код гос. органа
└ code— код отделения
└ name— наименование отделения
└ address— адрес отделения одной строкой
data.authorities.fts_reportИФНС отчётности,
структура аналогична fts_registration
data.authorities.pfОтделение Пенсионного фонда,
структура аналогична fts_registration
data.authorities.sif Отделение Фонда соц. страхования,
структура аналогична fts_registration
data.citizenshipГражданство ИП
└ code.numeric— числовой код страны по ОКСМ
└ code.alpha_3— трехбуквенный код страны по ОКСМ
└ name.full— полное наименование страны
└ name.short— краткое наименование страны

Только «Максимальный» тариф

Название Описание
data.founders[ ]Учредители компании
└ ogrn— ОГРН учредителя (для юрлиц)
└ inn— ИНН учредителя
└ name— наименование учредителя (для юрлиц)
└ fio— ФИО учредителя (для физлиц)
└ hid— внутренний идентификатор
└ type— тип учредителя (LEGAL / PHYSICAL)
└ start_date— дата вступления в права учредителя
data.founders[ ].shareДоля учредителя
└ type— тип значения (PERCENT / DECIMAL / FRACTION)
└ value— значение (для type = PERCENT и type = DECIMAL)
└ numerator— числитель дроби (для type = FRACTION)
└ denominator— знаменатель дроби (для type = FRACTION)
data.founders[ ].invalidity Недостоверность сведений об учредителе
└ code — код причины недостоверности
  PARTY  — обращение лица или организации
  FTS    — проверка налоговой
  COURT  — решение суда
  OTHER  — прочие причины
└ decision— решение суда (только для code = COURT)
    └ court_name— наименование суда
    └ number— номер судебного решения
    └ date— дата судебного решения
data.management.disqualified не заполняется
data.managers[ ]Руководители компании
└ ogrn— ОГРН руководителя (для юрлиц)
└ inn— ИНН руководителя
└ name— наименование руководителя (для юрлиц)
└ fio— ФИО руководителя (для физлиц)
└ post— должность руководителя (для физлиц)
└ hid— внутренний идентификатор
└ type — тип руководителя
  EMPLOYEE  — сотрудник
  LEGAL     — юрлицо
└ start_date— дата вступления в должность руководителя
data.managers[ ].invalidity Недостоверность сведений о руководителе
└ code — код причины недостоверности
  PARTY  — обращение лица или организации
  FTS    — проверка налоговой
  COURT  — решение суда
  OTHER  — прочие причины
└ decision— решение суда (только для code = COURT)
    └ court_name— наименование суда
    └ number— номер судебного решения
    └ date— дата судебного решения
data.predecessors[ ]Правопредшественники, только для юрлиц
└ ogrn— ОГРН предшественника
└ inn— ИНН предшественника
└ name— наименование предшественника
data.successors[ ]Правопреемники, только для юрлиц
└ ogrn— ОГРН преемника
└ inn— ИНН преемника
└ name— наименование преемника
data.capitalУставной капитал компании
└ type— тип капитала
└ value— размер капитала
data.finance Финансовые показатели за год
частично заполнены у 60% действующих компаний
└ year— год бух. отчетности
└ incomeдоходы по бух. отчетности
└ revenueвыручка по бух. отчетности
└ expenseрасходы по бух. отчетности
└ debt— недоимки по налогам
└ penalty— налоговые штрафы
data.documentsДокументы
data.documents.fts_registrationСвидетельство о регистрации в налоговой
└ type— тип документа (= FTS_REGISTRATION)
└ series— серия документа
└ number— номер документа
└ issue_date— дата выдачи
└ issue_authority— код подразделения
data.documents.fts_report Сведения об учете в налоговом органе, структура аналогична fts_registration
data.documents.pf_registration Свидетельство о регистрации в Пенсионном фонде, структура аналогична fts_registration
data.documents.sif_registration Свидетельство о регистрации в Фонде соц. страхования, структура аналогична fts_registration
data.documents.smb Запись в реестре малого и среднего предпринимательства
└ type— тип документа (= SMB)
└ category— категория предприятия (MICRO, SMALL или MEDIUM)
└ issue_date— дата регистрации в реестре
data.licenses[ ]Лицензии
└ series— серия документа
└ number— номер документа
└ issue_date— дата выдачи
└ issue_authority— название выдавшего органа
└ suspend_date— дата приостановки
└ suspend_authority— название приостановившего органа
└ valid_from— дата начала действия
└ valid_to— дата окончания действия
└ activities[ ]— перечень лицензируемых видов деятельности
└ addresses[ ]— перечень адресов, по которым действует лицензия
data.address.invalidity Недостоверность сведений об адресе
└ code — код причины недостоверности
  PARTY  — обращение лица или организации
  FTS    — проверка налоговой
  COURT  — решение суда
  OTHER  — прочие причины
└ decision— решение суда (только для code = COURT)
    └ court_name— наименование суда
    └ number— номер судебного решения
    └ date— дата судебного решения
data.phones[ ]Телефоны, заполнены у 60% действующих компаний
└ data.source— телефон одной строкой как в ЕГРЮЛ
└ data.type— тип телефона (мобильный, стационарный, ...)
└ data.country_code— код страны
└ data.city_code— код города / DEF-код
└ data.number— локальный номер телефона
└ data.provider— оператор связи
└ data.region— регион
└ data.city— город (только для стационарных телефонов)
└ data.timezone— часовой пояс
└ data.contact— контактное лицо
data.emails[ ]Адреса эл. почты, заполнены у 50% действующих компаний
└ data.source— email одной строкой как в ЕГРЮЛ
└ data.local— локальная часть адреса (то, что до «собачки»)
└ data.domain— домен (то, что после «собачки»)
data.invalid Признак недостоверных сведений об организации (true/null)
Не заполняются
data.source не заполняется
data.qc не заполняется

Доходы и расходы

Показатели рассчитываются по «Отчету о финансовых результатах» (форма по ОКУД 0710002):

  • Доходы = сумма по кодам 2110, 2310, 2320, 2340
  • Выручка = показатель по коду 2110
  • Расходы = сумма по кодам 2120, 2210, 2220, 2330, 2350

Доходы и расходы заполнены примерно у 60% действующих компаний (такая полнота данных в налоговой).

Недостоверные сведения об организации

Налоговая может признать сведения об учредителе, руководителе или адресе организации недостоверными. Тогда в ответе «Дадаты» будут заполнены соответствующие поля:

data.founders[ ].invalidity
data.managers[ ].invalidity
data.address[ ].invalidity

Если хотя бы один учредитель, руководитель или адрес организации признан недостоверным, «Дадата» вернет для организации в целом маркер data.invalid = true. Если недостоверных данных нет — будет data.invalid = null.

Источники данных:

Примеры вызова

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 30 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.