Документация API

Справочник API (OpenAPI)

Справочник собирается из спецификации, которую отдаёт сам API, — поэтому он совпадает с работающим кодом. Импортируйте спецификацию в Postman, Insomnia или генератор клиентов (openapi-generator, oapi-codegen).

Скачать openapi.jsonhttps://statsnet.co/api/v1/openapi.json
Базовый URL
https://statsnet.co/api/v1
Версия спецификации
1.0.0
Операций
40

Описания операций в спецификации — на английском.

Search

POST/companies/searchбез ключа

Search companies

Full-text company search by name, BIN/IIN or officer, with filters. Anonymous and free-account callers share a monthly search quota; API keys with a paid plan are metered by plan.

Параметры

ИмяГдеТипОписание
pagequeryintegerPage number (default: 1).
limitqueryintegerResults per page (1–500).

Пример тела запроса

{
  "query": "kaspi",
  "filters": {
    "jurisdiction": [
      "kz"
    ]
  }
}
Коды ответов200400429

Company profile

GET/companies/{company_id}ключ + тариф

Get Company

Retrieve detailed information about a company by its ID. Returns comprehensive company data including general info, officers, shareholders, contacts, addresses, financials, and more.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/dataключ + тариф

Available Data

List available data categories for a company. Returns counts of available data records across different categories for the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/mdбез ключа

Company card (Markdown)

Public company card rendered as Markdown — convenient for LLMs and AI agents. No authentication.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200404
GET/companies/{company_id}/meta/betaбез ключа

Metadata (Beta)

Get beta metadata for a company. Returns beta/experimental metadata for the specified company. This endpoint provides access to new data fields that are being tested before general availability.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200404429Подробнее и примеры кода →
GET/companies/{company_id}/paidключ + тариф

Get Company (Paid)

Retrieve full company data with premium access. Returns the full company record with all available data fields. Requires a Premium subscription plan.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company (first form).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/viewключ + тариф

View

Get new metadata view for a company. Returns an updated metadata view for the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/view/metaключ + тариф

View Metadata

Get display metadata for a company. Returns metadata used for displaying company information, including counts of available data in each category.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{jurisdiction}/{identifier}/mdбез ключа

Company card by identifier (Markdown)

Public company card by jurisdiction + national identifier, rendered as Markdown. No authentication.

Параметры

ИмяГдеТипОписание
jurisdictionобязательныйpathstringJurisdiction code, e.g. `kz`, `uz`, `kg`, `us-de`.
identifierобязательныйpathstringNational identifier of the company (BIN/IIN/INN, state file number).
Коды ответов200404
GET/companies/{jurisdiction}/{identifier}/paidключ + тариф

Get Company (Paid)

Retrieve full company data with premium access. Returns the full company record with all available data fields. Requires a Premium subscription plan.

Параметры

ИмяГдеТипОписание
jurisdictionобязательныйpathstringJurisdiction code, e.g. `kz`.
identifierобязательныйpathstringNational identifier (BIN/IIN/INN) of the company (second form).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/get_id/{jurisdiction}/{identifier}без ключа

Resolve company ID

Resolves a national identifier (BIN/IIN/INN) to the internal `company_id` used by the other endpoints. Response: `{"ID": 26334077}`.

Параметры

ИмяГдеТипОписание
jurisdictionобязательныйpathstringJurisdiction code, e.g. `kz`, `uz`, `kg`, `us-de`.
identifierобязательныйpathstringNational identifier of the company (BIN/IIN/INN, state file number).
Коды ответов200404

Company data

GET/companies/{company_id}/bank-accountsключ + тариф

Bank Accounts

Get bank account records for a company. Returns a paginated list of bank accounts associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/certsключ + тариф

Certificates

Get certificate records for a company. Returns a paginated list of certificates (conformity, origin, etc.) associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/court_casesключ + тариф

Court cases

Court cases where the company is a party. Full case details require a purchased company card.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page.
Коды ответов200401402403404429
GET/companies/{company_id}/debtorsключ + тариф

Debtors

Get debtor records for a company. Returns an aggregate debt summary for the specified company: the recoverer identifier, the total amount owed, and the number of enforcement proceeding records.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/departmentключ + тариф

Departments

Get department information for a company. Returns department/division information for the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/domainsключ + тариф

Domains

Get domain records for a company. Returns a paginated list of domains and websites associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/employeesключ + тариф

Employees

Get employee records for a company. Returns a paginated list of employees associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/eventsбез ключа

Events

Get event history for a company. Returns a paginated list of events (changes) recorded for the specified company, including changes to officers, addresses, status, and other attributes.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200404429Подробнее и примеры кода →
GET/companies/{company_id}/jobsключ + тариф

Jobs

Get job postings for a company. Returns a paginated list of job postings published by the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/licensesключ + тариф

Licenses

Get license records for a company. Returns a paginated list of licenses held by the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/pos_terminalsключ + тариф

POS Terminals

Get POS terminal records for a company. Returns a paginated list of POS (Point of Sale) terminals registered to the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/reviewключ + тариф

Reviews

Get review and website records for a company. Returns a paginated list of review websites and URLs associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/rightsключ + тариф

Rights

Get intellectual property rights for a company. Returns a paginated list of intellectual property rights (trademarks, patents, etc.) registered to the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/social_networksключ + тариф

Social Networks

Get social network profiles for a company. Returns a list of social network profiles associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/storesключ + тариф

Stores

Get store locations for a company. Returns a paginated list of stores and branch locations associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/tax_declarationsключ + тариф

Tax Declarations

Get tax declaration records for a company. Returns a paginated list of tax declarations and accruals for the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →

Contracts

GET/companies/{company_id}/contracts/metaбез ключа

Contracts Metadata

Get contract metadata for a company. Returns metadata about contracts associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200404429Подробнее и примеры кода →
GET/companies/{company_id}/gov_applicationsключ + тариф

Government Applications

Get government application records for a company. Returns a paginated list of government applications filed by or related to the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/gov-contractsключ + тариф

Government Contracts

Get government contract records for a company. Returns a paginated list of government procurement contracts where the specified company is either a supplier or customer.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/quasi_contractsключ + тариф

Quasi-Contracts

Get quasi-contract records for a company. Returns a paginated list of quasi-contracts associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/quasi_contracts/metaключ + тариф

Quasi-Contracts Metadata

Get quasi-contract metadata for a company. Returns metadata about quasi-contracts associated with the specified company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429Подробнее и примеры кода →

Relations

GET/companies/{company_id}/relationsключ + тариф

Relations (Graph)

Get company relations and affiliations as a graph. Returns company relations and affiliations in a graph format with nodes and links. Useful for visualizing corporate connections.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/relations_tableключ + тариф

Relations (Table)

Get company relations and affiliations as a list. Returns company relations and affiliations in a flat table format, suitable for tabular display.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
typequerystringOptional filter by connection type (e.g. `officers`, `shareholders`, `addresses`, `contacts`, `affiliations`, `branches`, `subsidiaries`).
Коды ответов200401402403404429Подробнее и примеры кода →
GET/companies/{company_id}/subsidiariesключ + тариф

Subsidiaries

Get subsidiary companies. Returns a paginated list of subsidiary companies associated with the specified parent company.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
pagequeryintegerPage number (default: 1).
limitqueryintegerRecords per page (default: 100).
Коды ответов200401402403404429Подробнее и примеры кода →

Contacts

GET/companies/{company_id}/contactsключ + тариф

Company contacts

Phones, emails and websites of the company, masked. Reveal full values with POST /companies/{company_id}/contacts/reveal. Officer/shareholder contacts require the Pro plan or above.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429
POST/companies/{company_id}/contacts/revealключ + тариф

Reveal company contacts

Returns the unmasked values of the company's contacts the caller's plan allows.

Параметры

ИмяГдеТипОписание
company_idобязательныйpathintegerThe unique identifier of the company.
Коды ответов200401402403404429

Individuals

GET/companies/individuals/{identifier}ключ + тариф

Individual by IIN

Profile of an individual by IIN: companies where the person is an officer or shareholder, risks. Requires a paid plan.

Параметры

ИмяГдеТипОписание
identifierобязательныйpathstringIIN of the individual (12 digits).
Коды ответов200401402403404429

Export

POST/exportключ + тариф

Bulk export

Builds an Excel or CSV file of companies matching the filters and returns it in the response body. Requires a plan with export rows; rows are charged against the plan's export allowance.

Пример тела запроса

{
  "type": "companies",
  "file_type": "excel",
  "filters": {
    "jurisdiction": [
      "kz"
    ],
    "main_industry_code": [
      "62010"
    ]
  }
}
Коды ответов200400401402403404429

Reference

GET/companies/states/{jurisdiction}без ключа

Regions of a jurisdiction

List of regions (states/oblasts) of a jurisdiction with company counts.

Параметры

ИмяГдеТипОписание
jurisdictionобязательныйpathstringJurisdiction code, e.g. `kz`, `uz`, `kg`, `us-de`.
Коды ответов200404