/pbnalog/companies

POST /api/pbnalog/companies

Price: 1 credit

Look up a Russian legal entity or sole proprietor by its INN, OGRN or OGRNIP in the Federal Tax Service's «Прозрачный бизнес» (Transparent Business) service. Returns the full EGRUL/EGRIP card: registered names, status, registration dates, address, charter capital, main and additional activities (OKVED), tax authority, management and founders, SME category, and the full set of tax transparency markers — applied special tax regimes, paid taxes by budget classification, tax arrears with amounts, average headcount, tax offenses, revenue/expense financials, mass-address co-located companies and mass manager/founder flags.

How to use it

Get the full Federal Tax Service transparency profile of a Russian company or sole proprietor by INN/OGRN/OGRNIP. Returns registration details, management, OKVED activities, and tax markers (special regimes, paid taxes, arrears with amounts, headcount, offenses, financials, mass-address and mass manager/founder flags).

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• query string required — INN (10 digits for a legal entity, 12 for a sole proprietor), OGRN (13 digits), OGRNIP (15 digits) or a record token returned by the search endpoint (examples: "7707083893", "1027700132195", "3663002880")

Response

• @type string (default: "PbnalogCompany")
• inn string required
• ogrn string nullable
• kpp string nullable
• name string required
• name_short string nullable
• np_type string required
• legal_form_code string nullable
• legal_form string nullable
• ip_kind_code string nullable
• ip_kind string nullable
• citizenship_code string nullable
• citizenship string nullable
• status string nullable
• status_code string nullable
• is_invalid boolean (default: false)
• is_foreign boolean (default: false)
• liquidated boolean (default: false)
• registered_at string nullable
• ogrn_date string nullable
• record_at string nullable
• registry_account_at string nullable
• excerpt_date string nullable
• address string nullable
• postal_code string nullable
• region_code string nullable
• region string nullable
• okved string nullable
• okved_name string nullable
• additional_activities array (default: [])
  • @type string (default: "PbnalogActivity")
  • code string required
  • name string nullable
• capital_amount number nullable
• capital_type string nullable
• tax_authority_code string nullable
• tax_authority string nullable
• registration_authority_code string nullable
• registration_authority string nullable
• msp_category string nullable (one of: "1", "2", "3")
• msp_category_name string nullable
• msp_registered_at string nullable
• managers array (default: [])
  • @type string (default: "PbnalogManager")
  • name string required
  • inn string nullable
  • position string nullable
  • mass_count integer nullable
  • is_mass boolean (default: false)
• founders array (default: [])
  • @type string (default: "PbnalogFounder")
  • name string required
  • inn string nullable
  • mass_count integer nullable
  • is_mass boolean (default: false)
• has_special_tax_mode boolean (default: false)
• has_paid_taxes boolean (default: false)
• has_arrears boolean (default: false)
• has_headcount boolean (default: false)
• has_offenses boolean (default: false)
• has_financials boolean (default: false)
• is_non_reporting boolean (default: false)
• has_tax_debt boolean (default: false)
• is_mass_manager boolean (default: false)
• is_mass_founder boolean (default: false)
• current_tax_modes array (default: [])
• paid_tax_total number nullable
• arrear_total number nullable
• headcount integer nullable
• revenue number nullable
• expense number nullable
• tax_payments array (default: [])
  • @type string (default: "PbnalogTaxPayment")
  • year integer required
  • kbk string nullable
  • name string nullable
  • amount number (default: 0)
• arrears array (default: [])
  • @type string (default: "PbnalogArrear")
  • year integer required
  • period integer nullable
  • kbk string nullable
  • name string nullable
  • arrear_amount number (default: 0)
  • penalty_amount number (default: 0)
  • fine_amount number (default: 0)
  • total_amount number (default: 0)
• headcounts array (default: [])
  • @type string (default: "PbnalogHeadcount")
  • year integer required
  • count integer (default: 0)
• tax_mode_periods array (default: [])
  • @type string (default: "PbnalogTaxModePeriod")
  • year integer required
  • period integer nullable
  • usn boolean (default: false)
  • eshn boolean (default: false)
  • envd boolean (default: false)
  • psn boolean (default: false)
  • npd boolean (default: false)
  • ausn boolean (default: false)
• offenses array (default: [])
  • @type string (default: "PbnalogOffense")
  • year integer required
• financials array (default: [])
  • @type string (default: "PbnalogFinancials")
  • year integer required
  • revenue number (default: 0)
  • expense number (default: 0)
• co_located array (default: [])
  • @type string (default: "PbnalogCoLocated")
  • inn string required
  • name string nullable
  • name_short string nullable
• gazette_publications array (default: [])
  • @type string (default: "PbnalogGazettePublication")
  • code integer nullable
  • count integer nullable
  • url string nullable
• excerpt_url string nullable
• founding_documents_url string nullable
• accounting_report_url string nullable
• sme_excerpt_url string nullable
• rafp_report_url 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 — No «Прозрачный бизнес» record matches this INN/OGRN/OGRNIP/token 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.