API docs

API reference (OpenAPI)

This reference is rendered from the specification the API itself serves, so it matches the running code. Import the spec into Postman, Insomnia or a client generator (openapi-generator, oapi-codegen).

Download openapi.jsonhttps://statsnet.co/api/v1/openapi.json

Base URL: https://statsnet.co/api/v1
Spec version: 1.0.0
Operations: 40

Search

POST/companies/searchno key needed

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.

Parameters

Name	In	Type	Description
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Results per page (1–500).

Request body example

{
  "query": "kaspi",
  "filters": {
    "jurisdiction": [
      "kz"
    ]
  }
}

Response codes200400429

Company profile

GET/companies/{company_id}key + plan

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.

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/datakey + plan

Available Data

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/mdno key needed

Company card (Markdown)

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200404

GET/companies/{company_id}/meta/betano key needed

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.

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200404429Details and code examples →

GET/companies/{company_id}/paidkey + plan

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.

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company (first form).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/viewkey + plan

View

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/view/metakey + plan

View Metadata

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429Details and code examples →

GET/companies/{jurisdiction}/{identifier}/mdno key needed

Company card by identifier (Markdown)

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

Parameters

Name	In	Type	Description
`jurisdiction`required	path	string	Jurisdiction code, e.g. `kz`, `uz`, `kg`, `us-de`.
`identifier`required	path	string	National identifier of the company (BIN/IIN/INN, state file number).

Response codes200404

GET/companies/{jurisdiction}/{identifier}/paidkey + plan

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.

Parameters

Name	In	Type	Description
`jurisdiction`required	path	string	Jurisdiction code, e.g. `kz`.
`identifier`required	path	string	National identifier (BIN/IIN/INN) of the company (second form).

Response codes200401402403404429Details and code examples →

GET/companies/get_id/{jurisdiction}/{identifier}no key needed

Resolve company ID

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

Parameters

Name	In	Type	Description
`jurisdiction`required	path	string	Jurisdiction code, e.g. `kz`, `uz`, `kg`, `us-de`.
`identifier`required	path	string	National identifier of the company (BIN/IIN/INN, state file number).

Response codes200404

Company data

GET/companies/{company_id}/bank-accountskey + plan

Bank Accounts

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/certskey + plan

Certificates

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/court_caseskey + plan

Court cases

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page.

Response codes200401402403404429

GET/companies/{company_id}/debtorskey + plan

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.

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/departmentkey + plan

Departments

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/domainskey + plan

Domains

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/employeeskey + plan

Employees

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/eventsno key needed

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.

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200404429Details and code examples →

GET/companies/{company_id}/jobskey + plan

Jobs

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/licenseskey + plan

Licenses

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/pos_terminalskey + plan

POS Terminals

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/reviewkey + plan

Reviews

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/rightskey + plan

Rights

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/social_networkskey + plan

Social Networks

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/storeskey + plan

Stores

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/tax_declarationskey + plan

Tax Declarations

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

Contracts

GET/companies/{company_id}/contracts/metano key needed

Contracts Metadata

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200404429Details and code examples →

GET/companies/{company_id}/gov_applicationskey + plan

Government Applications

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/gov-contractskey + plan

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.

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/quasi_contractskey + plan

Quasi-Contracts

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/quasi_contracts/metakey + plan

Quasi-Contracts Metadata

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429Details and code examples →

Relations

GET/companies/{company_id}/relationskey + plan

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.

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/relations_tablekey + plan

Relations (Table)

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).
`type`	query	string	Optional filter by connection type (e.g. `officers`, `shareholders`, `addresses`, `contacts`, `affiliations`, `branches`, `subsidiaries`).

Response codes200401402403404429Details and code examples →

GET/companies/{company_id}/subsidiarieskey + plan

Subsidiaries

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.
`page`	query	integer	Page number (default: 1).
`limit`	query	integer	Records per page (default: 100).

Response codes200401402403404429Details and code examples →

Contacts

GET/companies/{company_id}/contactskey + plan

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.

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429

POST/companies/{company_id}/contacts/revealkey + plan

Reveal company contacts

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

Parameters

Name	In	Type	Description
`company_id`required	path	integer	The unique identifier of the company.

Response codes200401402403404429

Individuals

GET/companies/individuals/{identifier}key + plan

Individual by IIN

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

Parameters

Name	In	Type	Description
`identifier`required	path	string	IIN of the individual (12 digits).

Response codes200401402403404429

Export

POST/exportkey + plan

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.

Request body example

{
  "type": "companies",
  "file_type": "excel",
  "filters": {
    "jurisdiction": [
      "kz"
    ],
    "main_industry_code": [
      "62010"
    ]
  }
}

Response codes200400401402403404429

Reference

GET/companies/states/{jurisdiction}no key needed

Regions of a jurisdiction

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

Parameters

Name	In	Type	Description
`jurisdiction`required	path	string	Jurisdiction code, e.g. `kz`, `uz`, `kg`, `us-de`.

Response codes200404