/zachestnyibiznes/companies/search

POST /api/zachestnyibiznes/companies/search

Price: 10 credits

Search Russian companies and sole proprietors (FNS/EGRUL/EGRIP registry) by name, INN, OGRN, address or person, with filters by registration status, region, legal form (OKOPF), ownership form (OKFS), activity (OKVED), special tax regime, contacts, presence of branches/financials, and ranges on revenue, charter capital, headcount and registration date.

How to use it

Search the Russian company registry. Provide query (name/INN/OGRN/address/person) and count. Optional filters: entity_type (ul/ip), status (one or more), region, legal_form, ownership_form, okved, additional_okved, licenses (one or more authorities), tax_mode (one or more), contacts, has_subdivisions, has_financials, and numeric ranges revenue_min/max, net_profit_min/max, profit_before_tax_min/max, balance_min/max, receivables_min/max, payables_min/max, fixed_assets_min/max, inventory_min/max, charter_capital_min/max, employees_min/max, arbitration_as_defendant_amount/count_min/max, arbitration_as_plaintiff_amount/count_min/max, and registered_after/before (DD.MM.YYYY). Each result has id (OGRN), url, company_type, name, status, inn, ogrn, director, director_url, address, charter_capital, registered_at.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• query string required — Search query: company name, INN, OGRN, address or person name (minLength: 1)
• count integer required — Max number of results to return (min: 1)
• entity_type string nullable — Restrict to legal entities (ul) or sole proprietors (ip) (one of: "ul", "ip")
• status array nullable — Registration status filter (one or more) (one of: "active", "liquidating", "reorganizing", "liquidated", "bankrupting", "registration_erroneous", "registration_invalid", "bankruptcy_case_opened")
• region string nullable — Russian region/federal subject of registration (one of: "respublika_adygeya", "respublika_bashkortostan", "respublika_buryatiya", "respublika_altay", "respublika_dagestan", "respublika_ingushetiya", "kabardino_balkarskaya_respublika", "respublika_kalmykiya", "karachaevo_cherkesskaya_respublika", "respublika_kareliya", "respublika_komi", "respublika_mariy_el", "respublika_mordoviya", "respublika_saha_yakutiya", "respublika_severnaya_osetiya_alaniya", "respublika_tatarstan_tatarstan", "respublika_tyva", "udmurtskaya_respublika", "respublika_hakasiya", "chechenskaya_respublika", "chuvashskaya_respublika_chuvashiya", "altayskiy_kray", "krasnodarskiy_kray", "krasnoyarskiy_kray", "primorskiy_kray", "stavropolskiy_kray", "habarovskiy_kray", "amurskaya_oblast", "arhangelskaya_oblast", "astrahanskaya_oblast", "belgorodskaya_oblast", "bryanskaya_oblast", "vladimirskaya_oblast", "volgogradskaya_oblast", "vologodskaya_oblast", "voronezhskaya_oblast", "ivanovskaya_oblast", "irkutskaya_oblast", "kaliningradskaya_oblast", "kaluzhskaya_oblast", "kamchatskiy_kray", "kemerovskaya_oblast", "kirovskaya_oblast", "kostromskaya_oblast", "kurganskaya_oblast", "kurskaya_oblast", "leningradskaya_oblast", "lipetskaya_oblast", "magadanskaya_oblast", "moskovskaya_oblast", "murmanskaya_oblast", "nizhegorodskaya_oblast", "novgorodskaya_oblast", "novosibirskaya_oblast", "omskaya_oblast", "orenburgskaya_oblast", "orlovskaya_oblast", "penzenskaya_oblast", "permskiy_kray", "pskovskaya_oblast", "rostovskaya_oblast", "ryazanskaya_oblast", "samarskaya_oblast", "saratovskaya_oblast", "sahalinskaya_oblast", "sverdlovskaya_oblast", "smolenskaya_oblast", "tambovskaya_oblast", "tverskaya_oblast", "tomskaya_oblast", "tulskaya_oblast", "tyumenskaya_oblast", "ulyanovskaya_oblast", "chelyabinskaya_oblast", "zabaykalskiy_kray", "yaroslavskaya_oblast", "moskva", "sankt_peterburg", "evreyskaya_avtonomnaya_oblast", "nenetskiy_avtonomnyy_okrug", "hanty_mansiyskiy_avtonomnyy_okrug_yugra", "chukotskiy_avtonomnyy_okrug", "yamalo_nenetskiy_avtonomnyy_okrug", "zaporozhskaya_oblast", "respublika_krym", "sevastopol", "donetskaya_narodnaya_respublika", "luganskaya_narodnaya_respublika", "hersonskaya_oblast", "inye_territorii_vklyuchaya_gorod_i_kosmodrom_bay")
• legal_form string nullable — Legal form (OKOPF), e.g. LLC or public JSC (one of: "hozyaystvennye_tovarischestva", "polnye_tovarischestva", "tovarischestva_na_vere_kommanditnye_tovarischest", "hozyaystvennye_obschestva", "aktsionernye_obschestva", "publichnye_aktsionernye_obschestva", "nepublichnye_aktsionernye_obschestva", "obschestva_s_ogranichennoy_otvetstvennostyu", "hozyaystvennye_partnerstva", "proizvodstvennye_kooperativy_arteli", "selskohozyaystvennye_proizvodstvennye_kooperativ", "selskohozyaystvennye_arteli_kolhozy", "rybolovetskie_arteli_kolhozy", "kooperativnye_hozyaystva_koophozy", "proizvodstvennye_kooperativy_krome_selskohozyays", "krestyanskie_fermerskie_hozyaystva", "prochie_yuridicheskie_litsa_yavlyayuschiesya_kom", "potrebitelskie_kooperativy", "garazhnye_i_garazhno_stroitelnye_kooperativy", "zhilischnye_ili_zhilischno_stroitelnye_kooperati", "zhilischnye_nakopitelnye_kooperativy", "kreditnye_potrebitelskie_kooperativy", "kreditnye_potrebitelskie_kooperativy_grazhdan", "kreditnye_kooperativy_vtorogo_urovnya", "potrebitelskie_obschestva", "obschestva_vzaimnogo_strahovaniya", "selskohozyaystvennye_potrebitelskie_pererabatyva", "selskohozyaystvennye_potrebitelskie_sbytovye_tor", "selskohozyaystvennye_potrebitelskie_obsluzhivayu", "selskohozyaystvennye_potrebitelskie_snabzhenches", "selskohozyaystvennye_potrebitelskie_zhivotnovodc", "selskohozyaystvennye_potrebitelskie_rastenievodc", "fondy_prokata", "obschestvennye_organizatsii", "politicheskie_partii", "profsoyuznye_organizatsii", "obschestvennye_dvizheniya", "organy_obschestvennoy_samodeyatelnosti", "territorialnye_obschestvennye_samoupravleniya", "assotsiatsii_soyuzy", "assotsiatsii_soyuzy_ekonomicheskogo_vzaimodeystv", "sovety_munitsipalnyh_obrazovaniy_subektov_rossiy", "soyuzy_assotsiatsii_kreditnyh_kooperativov", "soyuzy_assotsiatsii_kooperativov", "soyuzy_assotsiatsii_obschestvennyh_obedineniy", "soyuzy_assotsiatsii_obschin_malochislennyh_narod", "soyuzy_potrebitelskih_obschestv", "advokatskie_palaty", "notarialnye_palaty", "torgovo_promyshlennye_palaty", "obedineniya_rabotodateley", "obedineniya_fermerskih_hozyaystv", "nekommercheskie_partnerstva", "advokatskie_byuro", "kollegii_advokatov", "samoreguliruemye_organizatsii", "obedineniya_assotsiatsii_i_soyuzy_blagotvoriteln", "tovarischestva_sobstvennikov_nedvizhimosti", "sadovodcheskie_ili_ogorodnicheskie_nekommerchesk", "tovarischestva_sobstvennikov_zhilya", "kazachi_obschestva_vnesennye_v_gosudarstvennyy_r", "obschiny_korennyh_malochislennyh_narodov_rossiys", "predstavitelstva_yuridicheskih_lits", "filialy_yuridicheskih_lits", "obosoblennye_podrazdeleniya_yuridicheskih_lits", "strukturnye_podrazdeleniya_obosoblennyh_podrazde", "paevye_investitsionnye_fondy", "prostye_tovarischestva", "rayonnye_sudy_gorodskie_sudy_mezhrayonnye_sudy_r", "mezhpravitelstvennye_mezhdunarodnye_organizatsii", "nepravitelstvennye_mezhdunarodnye_organizatsii", "organizatsionno_pravovye_formy_dlya_kommerchesko", "glavy_krestyanskih_fermerskih_hozyaystv", "individualnye_predprinimateli", "organizatsionno_pravovye_formy_dlya_deyatelnosti", "advokaty_uchredivshie_advokatskiy_kabinet", "notariusy_zanimayuschiesya_chastnoy_praktikoy", "unitarnye_predpriyatiya", "unitarnye_predpriyatiya_osnovannye_na_prave_oper", "federalnye_kazennye_predpriyatiya", "kazennye_predpriyatiya_subektov_rossiyskoy_feder", "munitsipalnye_kazennye_predpriyatiya", "unitarnye_predpriyatiya_osnovannye_na_prave_hozy", "federalnye_gosudarstvennye_unitarnye_predpriyati", "gosudarstvennye_unitarnye_predpriyatiya_subektov", "munitsipalnye_unitarnye_predpriyatiya", "fondy", "blagotvoritelnye_fondy", "negosudarstvennye_pensionnye_fondy", "obschestvennye_fondy", "ekologicheskie_fondy", "avtonomnye_nekommercheskie_organizatsii", "religioznye_organizatsii", "publichno_pravovye_kompanii", "gosudarstvennye_korporatsii", "gosudarstvennye_kompanii", "otdeleniya_inostrannyh_nekommercheskih_nepravite", "uchrezhdeniya", "uchrezhdeniya_sozdannye_rossiyskoy_federatsiey", "federalnye_gosudarstvennye_avtonomnye_uchrezhden", "federalnye_gosudarstvennye_byudzhetnye_uchrezhde", "federalnye_gosudarstvennye_kazennye_uchrezhdeniy", "uchrezhdeniya_sozdannye_subektom_rossiyskoy_fede", "gosudarstvennye_avtonomnye_uchrezhdeniya_subekto", "gosudarstvennye_byudzhetnye_uchrezhdeniya_subekt", "gosudarstvennye_kazennye_uchrezhdeniya_subektov", "gosudarstvennye_akademii_nauk", "uchrezhdeniya_sozdannye_munitsipalnym_obrazovani", "munitsipalnye_avtonomnye_uchrezhdeniya", "munitsipalnye_byudzhetnye_uchrezhdeniya", "munitsipalnye_kazennye_uchrezhdeniya", "chastnye_uchrezhdeniya", "blagotvoritelnye_uchrezhdeniya", "obschestvennye_uchrezhdeniya")
• ownership_form string nullable — Ownership form (OKFS), e.g. private or federal (one of: "rossiyskaya_sobstvennost", "gosudarstvennaya_sobstvennost", "federalnaya_sobstvennost", "sobstvennost_subektov_rossiyskoy_federatsii", "munitsipalnaya_sobstvennost", "chastnaya_sobstvennost", "sobstvennost_rossiyskih_grazhdan_postoyanno_proz", "sobstvennost_potrebitelskoy_kooperatsii", "sobstvennost_obschestvennyh_i_religioznyh_organi", "sobstvennost_blagotvoritelnyh_organizatsiy", "sobstvennost_politicheskih_obschestvennyh_obedin", "sobstvennost_professionalnyh_soyuzov", "sobstvennost_obschestvennyh_obedineniy", "sobstvennost_religioznyh_obedineniy", "smeshannaya_rossiyskaya_sobstvennost", "smeshannaya_rossiyskaya_sobstvennost_s_doley_gos", "smeshannaya_rossiyskaya_sobstvennost_s_doley_fed", "smeshannaya_rossiyskaya_sobstvennost_s_doley_sob", "smeshannaya_rossiyskaya_sobstvennost_s_dolyami_f", "inaya_smeshannaya_rossiyskaya_sobstvennost", "sobstvennost_gosudarstvennyh_korporatsiy", "inostrannaya_sobstvennost", "sobstvennost_mezhdunarodnyh_organizatsiy", "sobstvennost_inostrannyh_gosudarstv", "sobstvennost_inostrannyh_yuridicheskih_lits", "sobstvennost_inostrannyh_grazhdan_i_lits_bez_gra", "smeshannaya_inostrannaya_sobstvennost", "sovmestnaya_rossiyskaya_i_inostrannaya_sobstvenn", "sovmestnaya_federalnaya_i_inostrannaya_sobstvenn", "sovmestnaya_sobstvennost_subektov_rossiyskoy_fed", "sovmestnaya_munitsipalnaya_i_inostrannaya_sobstv", "sovmestnaya_chastnaya_i_inostrannaya_sobstvennos", "sovmestnaya_sobstvennost_obschestvennyh_i_religi")
• okved string nullable — Primary OKVED activity code (e.g. 62.01)
• additional_okved string nullable — Additional (secondary) OKVED activity code to match (e.g. 62.02)
• licenses array nullable — Only companies holding licences from these authorities (one or more) (one of: "alcohol", "rospotrebnadzor", "roszdravnadzor", "rostehnadzor", "minkultury", "minpromtorg_avia", "minpromtorg_med", "minpromtorg_weapon", "fns", "obrnadzor")
• tax_mode array nullable — Special tax-regime filter (one or more) (one of: "eshn", "usn", "envd", "srp", "ausn", "none")
• contacts string nullable — Filter by presence of contact details (one of: "with_contacts", "without_contacts", "all")
• has_subdivisions boolean nullable — Only companies that have branches/subdivisions
• has_financials boolean nullable — Only companies that have published financial reporting
• revenue_min integer nullable — Minimum annual revenue in RUB (min: 0)
• revenue_max integer nullable — Maximum annual revenue in RUB (min: 0)
• net_profit_min integer nullable — Minimum net profit in RUB
• net_profit_max integer nullable — Maximum net profit in RUB
• profit_before_tax_min integer nullable — Minimum profit before tax in RUB
• profit_before_tax_max integer nullable — Maximum profit before tax in RUB
• balance_min integer nullable — Minimum balance-sheet total (assets) in RUB (min: 0)
• balance_max integer nullable — Maximum balance-sheet total (assets) in RUB (min: 0)
• receivables_min integer nullable — Minimum accounts receivable in RUB (min: 0)
• receivables_max integer nullable — Maximum accounts receivable in RUB (min: 0)
• payables_min integer nullable — Minimum accounts payable in RUB (min: 0)
• payables_max integer nullable — Maximum accounts payable in RUB (min: 0)
• fixed_assets_min integer nullable — Minimum fixed assets in RUB (min: 0)
• fixed_assets_max integer nullable — Maximum fixed assets in RUB (min: 0)
• inventory_min integer nullable — Minimum inventory in RUB (min: 0)
• inventory_max integer nullable — Maximum inventory in RUB (min: 0)
• charter_capital_min integer nullable — Minimum charter capital in RUB (min: 0)
• charter_capital_max integer nullable — Maximum charter capital in RUB (min: 0)
• employees_min integer nullable — Minimum headcount (min: 0)
• employees_max integer nullable — Maximum headcount (min: 0)
• arbitration_as_defendant_amount_min integer nullable — Minimum total claim amount where the company is a defendant, in RUB (min: 0)
• arbitration_as_defendant_amount_max integer nullable — Maximum total claim amount where the company is a defendant, in RUB (min: 0)
• arbitration_as_defendant_count_min integer nullable — Minimum number of arbitration cases as a defendant (min: 0)
• arbitration_as_defendant_count_max integer nullable — Maximum number of arbitration cases as a defendant (min: 0)
• arbitration_as_plaintiff_amount_min integer nullable — Minimum total claim amount where the company is a plaintiff, in RUB (min: 0)
• arbitration_as_plaintiff_amount_max integer nullable — Maximum total claim amount where the company is a plaintiff, in RUB (min: 0)
• arbitration_as_plaintiff_count_min integer nullable — Minimum number of arbitration cases as a plaintiff (min: 0)
• arbitration_as_plaintiff_count_max integer nullable — Maximum number of arbitration cases as a plaintiff (min: 0)
• registered_after string nullable — Registered on or after this date (DD.MM.YYYY)
• registered_before string nullable — Registered on or before this date (DD.MM.YYYY)

Response

• @type string (default: "ZachestnyibiznesSearchResult")
• id string required
• url string required
• company_type string required
• name string nullable
• status string nullable
• inn string nullable
• ogrn string nullable
• director string nullable
• director_url string nullable
• address string nullable
• charter_capital integer nullable
• registered_at string nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.