DEVELOPER
One registry over the API
Country-agnostic schema: the same shape for any jurisdiction. Base URL — api.safedeal.kz.
Authentication
Every request needs an API key in the X-API-Key header. Generate your key in the dashboard.
curl https://api.safedeal.kz/api/v2/kz/companies/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Base URL
All endpoints mount under api.safedeal.kz. kz in the path is the country code (e.g. kz).
Errors
Errors use RFC 9457 (problem+json): type, title, status, detail. The HTTP status code reflects the error.
{ "type", "title", "status", "detail" }Pagination
List endpoints accept page and per_page; the response carries total_count.
Integrations
SafeDeal is first and foremost an API. A counterparty check by BIN/IIN can be embedded into any of your systems: a CRM, accounting software, spreadsheets or your own product. The data — risks, finances, status, PDF report — is returned automatically, with no manual visit to the site.
REST API Available
Direct integration into any product — the primary way to connect.
Excel / Google Sheets Available
Bulk-check a list of BIN/IIN and export reports as a spreadsheet.
Битрикс24 On request
Check a counterparty right inside the CRM card. Connector built on our API.
amoCRM On request
Enrich deals and companies with SafeDeal data and risks.
1С On request
Check counterparties from your accounting system by BIN.
How it works
- 1Get an API key in your account (Profile → “API”).
- 2On an event in your system (a company added by BIN) call our API.
- 3Write the response (risks / finances / status / PDF link) into the card fields.
curl https://api.safedeal.kz/api/v2/kz/companies/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Bitrix24 — step by step
What you get: a counterparty check right inside the company or deal card — by BIN it pulls risks, financial standing and status from SafeDeal.
- 1In SafeDeal, copy the API key (Profile → “API”).
- 2In Bitrix24 create an inbound webhook or a local application (Developers → Other → “Inbound webhook” / “Local application”) with access to the CRM.
- 3Set up a robot or a business process in the CRM: on adding/updating a company, take the BIN from a card field and call our API (example below).
- 4Parse the JSON response and write the values into card fields (risk, status, registration date) or show a link to the PDF report.
# Bitrix calls our API by the company identifier curl https://api.safedeal.kz/api/v2/kz/companies/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
The company identifier is found by searching by BIN (see the reference below); the full list of response fields is in the reference sections (company, risks, finances, taxes, courts, etc.). A ready-made app for the Bitrix marketplace is available on request.
Need help with integration or a ready-made connector for your system?
Meta
GET/api/v2/{country}/features
Get available features for the country
Parameters
| countryrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/features \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200Features
{
"accreditations": true,
"arrest": true,
"bank": true,
"certificate": true,
"company": true,
"court": true,
"founders": true,
"head_participation": true,
"procurement": true,
"risk": true,
"search": true,
"tax": true
}GET/api/v2/{country}/info
Static country metadata with per-region company counts
Parameters
| countryrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/info \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200CountryInfo
{
"classifiers": {
"activity": {
"code": "string",
"name": "string"
},
"extra": [
{
"header": true,
"key": "string",
"label": "string"
}
],
"region": {
"code": "string",
"name": "string"
}
},
"code": "string",
"currency": {
"code": "string",
"locale": "string",
"symbol": "string"
},
"filters": {
"legalForms": [
{
"code": "string",
"count": 0,
"label": "string",
"labels": {},
"value": "string"
}
],
"ownership": [
{
"code": "string",
"count": 0,
"label": "string",
"labels": {},
"value": "string"
}
],
"sizeClasses": [
{
"code": "string",
"count": 0,
"label": "string",
"labels": {},
"value": "string"
}
]
},
"flag": "string",
"identifiers": [
{
"appliesTo": [
"string"
],
"code": "string",
"full": "string",
"length": 0,
"personal": true,
"primary": true,
"role": "string",
"short": "string"
}
],
"locale": {
"dateFormat": "string",
"default": "string",
"numberLocale": "string",
"phoneCode": "string"
},
"map": {
"available": true
},
"name": {
"en": "string",
"genitive": "string",
"kk": "string",
"nominative": "string",
"prepositional": "string"
},
"regions": [
{
"apiValue": "string",
"count": 0,
"kato": "string",
"name": {
"genitive": "string",
"nominative": "string"
},
"slug": "string"
}
],
"sources": [
{
"description": "string",
"itemUrlTemplate": "string",
"key": "string",
"name": "string",
"role": "string",
"url": "string"
}
],
"tax": {
"vatApplicable": true
},
"tools": [
{
"name": "string",
"slug": "string"
}
]
}GET/api/v2/{country}/stats
Public coverage stats for the landing page
Parameters
| countryrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/stats \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200Stats
{
"companies": 0,
"jurisdictions": 0,
"risk_checks": 0
}Search & discovery
GET/api/v2/{country}/alternatives
Get alternative companies
Parameters
| countryrequired | path · string | |
| registration_number | query · string | |
| industry_code | query · string |
curl https://api.safedeal.kz/api/v2/kz/alternatives \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200AlternativesResult
{
"items": [
{
"active": true,
"address_area": "string",
"address_full": "string",
"employee_count": "string",
"extra": {},
"head": "string",
"id": 0,
"industry": "string",
"industry_code": "string",
"legal_form": "string",
"name": "string",
"registration_date": "2026-01-01T00:00:00Z",
"registration_number": "string",
"size": "string",
"status": "string",
"status_code": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/catalog
Browse company catalog
Parameters
| countryrequired | path · string | |
| area | query · string | |
| industry_code | query · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/catalog \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200CatalogResult
{
"items": [
{
"active": true,
"address_area": "string",
"address_full": "string",
"employee_count": "string",
"extra": {},
"head": "string",
"id": 0,
"industry": "string",
"industry_code": "string",
"legal_form": "string",
"name": "string",
"registration_date": "2026-01-01T00:00:00Z",
"registration_number": "string",
"size": "string",
"status": "string",
"status_code": "string"
}
],
"page": 0,
"per_page": 0,
"stats": {
"active": 0,
"inactive": 0,
"top_industries": [
{
"code": "string",
"count": 0,
"name": "string"
}
]
},
"total_count": 0
}GET/api/v2/{country}/search
Search companies
Parameters
| countryrequired | path · string | |
| qrequired | query · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/search \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200SearchResult
{
"items": [
{
"active": true,
"address": "string",
"address_area": "string",
"country_code": "string",
"employee_count": "string",
"extra": {},
"head": "string",
"id": 0,
"industry_code": "string",
"industry_name": "string",
"legal_form": "string",
"name": "string",
"registration_date": "2026-01-01T00:00:00Z",
"registration_number": "string",
"size": "string",
"status": "string",
"status_code": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}POST/api/v2/{country}/search/advanced
Advanced company search
Parameters
| countryrequired | path · string |
curl -X POST https://api.safedeal.kz/api/v2/kz/search/advanced \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200SearchResult
{
"items": [
{
"active": true,
"address": "string",
"address_area": "string",
"country_code": "string",
"employee_count": "string",
"extra": {},
"head": "string",
"id": 0,
"industry_code": "string",
"industry_name": "string",
"legal_form": "string",
"name": "string",
"registration_date": "2026-01-01T00:00:00Z",
"registration_number": "string",
"size": "string",
"status": "string",
"status_code": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}POST/api/v2/{country}/tenders/search
Search tenders
Parameters
| countryrequired | path · string |
curl -X POST https://api.safedeal.kz/api/v2/kz/tenders/search \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200TenderSearchResult
{
"has_next": true,
"items": [
{
"count_lots": 0,
"end_date": "string",
"extra": {},
"id": 0,
"last_update_date": "string",
"method": "string",
"name": "string",
"organizer_name": "string",
"organizer_registration_number": "string",
"publish_date": "string",
"start_date": "string",
"status": "string",
"supplier_registration_number": "string",
"total_sum": 0
}
],
"last_id": 0,
"total_count": 0
}Company
GET/api/v2/{country}/companies/{id}
Get company data by ID
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200CompanyCard
{
"active": true,
"address": {
"city": "string",
"full": "string",
"postal_code": "string",
"region": "string",
"street": "string"
},
"country_code": "string",
"created_at": "2026-01-01T00:00:00Z",
"employee_count": "string",
"extra": {},
"full_name": "string",
"head": {
"name": "string",
"position": "string"
},
"id": 0,
"identifiers": [
{
"code": "string",
"value": "string"
}
],
"industry_code": "string",
"industry_codes": [
"string"
],
"industry_name": "string",
"legal_form": "string",
"name": "string",
"name_local": "string",
"old_heads": [
"string"
],
"paid": true,
"registration_date": "2026-01-01T00:00:00Z",
"registration_number": "string",
"roles": "string",
"size": "string",
"status": "string",
"status_code": "string",
"updated_at": "2026-01-01T00:00:00Z"
}GET/api/v2/{country}/companies/{id}/access
Check the user's paid access to a company without spending a check
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/access \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200AccessInfo
{
"paid": true
}GET/api/v2/{country}/companies/{id}/accounting
Get company accounting report
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/accounting \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200AccountingReport
{
"chief_name": "string",
"sections": [
{
"lines": [
{
"code": "string",
"current_value": "string",
"name": "string",
"previous_value": "string"
}
],
"name": "string"
}
]
}GET/api/v2/{country}/companies/{id}/accreditations
Get company accreditations / program memberships
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/accreditations \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200AccreditationsResult
{
"items": [
{
"certificate_number": "string",
"issued_date": "string",
"program_code": "string",
"program_name": "string",
"status": "string",
"valid_until": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/affiliations
Get company affiliations
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| direction | query · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/affiliations \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200AffiliationsResult
{
"head": "string",
"items": [
{
"direction": "up",
"name": "string",
"note": "string",
"reason": "string",
"registration_number": "string",
"type": "string"
}
],
"legal_form": "string",
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/arrests
Get company financial arrests
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/arrests \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200ArrestsResult
{
"active_sum": 0,
"active_total": 0,
"checks": [
{
"found": true,
"type": "string"
}
],
"items": [
{
"amount": 0,
"authority": "string",
"collector": "string",
"collector_registration_number": "string",
"collector_type": "string",
"currency": "string",
"date": "2026-01-01T00:00:00Z",
"debt_amount": 0,
"department": "string",
"description": "string",
"number": "string",
"status": "string",
"status_code": "string",
"type": "string"
}
],
"other_sum": 0,
"other_total": 0,
"page": 0,
"per_page": 0,
"returned_sum": 0,
"returned_total": 0,
"sum": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/bank-accounts
Get company bank accounts
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/bank-accounts \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200BankAccountsResult
{
"items": [
{
"account_num": "string",
"bank_code": "string",
"bank_name": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/branches
Get company branches
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/branches \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200BranchesResult
{
"items": [
{
"address": {
"city": "string",
"full": "string",
"postal_code": "string",
"region": "string",
"street": "string"
},
"id": 0,
"name": "string",
"registration_number": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/certificates
Get company certificates
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer | |
| type | query · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/certificates \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200CertificatesResult
{
"items": [
{
"expiry_date": "2026-01-01T00:00:00Z",
"id": "string",
"issued_by": "string",
"issued_date": "2026-01-01T00:00:00Z",
"name": "string",
"number": "string",
"status": "string",
"type": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/certificates/meta
Get certificates statistics
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/certificates/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200CertificatesMeta
{
"counts": {},
"total": 0
}GET/api/v2/{country}/companies/{id}/contacts
Get company contact information
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/contacts \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200ContactsResult
{
"emails": [
"string"
],
"phones": [
"string"
],
"total_count": 0,
"websites": [
"string"
]
}GET/api/v2/{country}/companies/{id}/contracts
Get company procurement contracts
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/contracts \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200ContractsResult
{
"items": [
{
"amount": 0,
"currency": "string",
"customer_name": "string",
"customer_reg_num": "string",
"extra": {},
"id": "string",
"number": "string",
"sign_date": "2026-01-01T00:00:00Z",
"status": "string",
"subject": "string",
"supplier_name": "string",
"supplier_reg_num": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/contracts/by-year
Get contracts aggregated by calendar year (supplier and customer)
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/contracts/by-year \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200ContractsByYear
{
"customer": [
{
"count": 0,
"currency": "string",
"government_entity": 0,
"status": "string",
"status_id": 0,
"sum": 0,
"sum_vat": 0,
"year": 0
}
],
"supplier": [
{
"count": 0,
"currency": "string",
"government_entity": 0,
"status": "string",
"status_id": 0,
"sum": 0,
"sum_vat": 0,
"year": 0
}
]
}GET/api/v2/{country}/companies/{id}/contracts/meta
Get contracts statistics
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/contracts/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200ContractsMeta
{
"as_customer": 0,
"as_supplier": 0,
"currency": "string",
"government_entity": 0,
"sum_vat": 0,
"total_amount": 0,
"total_contracts": 0
}GET/api/v2/{country}/companies/{id}/court-cases
Get company court cases
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer | |
| status | query · string | |
| role | query · string | |
| year_from | query · integer | |
| year_to | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/court-cases \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200CourtCasesResult
{
"items": [
{
"amount": 0,
"case_number": "string",
"category": "string",
"court": "string",
"currency": "string",
"defendants": [
"string"
],
"end_date": "2026-01-01T00:00:00Z",
"extra": {},
"plaintiffs": [
"string"
],
"start_date": "2026-01-01T00:00:00Z",
"status": "string",
"status_code": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/court-cases/meta
Get court cases statistics
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/court-cases/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200CourtCasesMeta
{
"active_cases": 0,
"as_defendant": 0,
"as_plaintiff": 0,
"by_category": [
{
"code": "string",
"count": 0
}
],
"completed_cases": 0,
"total_cases": 0
}GET/api/v2/{country}/companies/{id}/court-cases/status
Get court cases worker status
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/court-cases/status \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200CourtWorkerStatus
{
"created_at": "string",
"current_area": "string",
"current_court": "string",
"current_year": 0,
"status": "string",
"updated_at": "string"
}GET/api/v2/{country}/companies/{id}/employees
Get company employees
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/employees \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200EmployeesInfo
{
"employees": [
{
"name": "string",
"position": "string"
}
]
}GET/api/v2/{country}/companies/{id}/events
Get company events
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/events \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200EventsResult
{
"items": [
{
"date": "2026-01-01T00:00:00Z",
"description": "string",
"id": 0,
"new_value": "string",
"old_value": "string",
"type": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/events/meta
Get aggregated change-history metadata
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/events/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200EventsMeta
{
"by_type": [
{
"count": 0,
"type": "string"
}
],
"total_count": 0
}GET/api/v2/{country}/companies/{id}/finances
Get company financial reports
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/finances \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200FinancesResult
{
"items": [
{
"currency": "string",
"expense": 0,
"extra": {},
"profit": 0,
"revenue": 0,
"type": "string",
"year": 0
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/founders
Get company founders/shareholders
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/founders \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200FoundersResult
{
"items": [
{
"inactive": true,
"is_person": true,
"name": "string",
"registration_number": "string",
"share": 0
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/head-participation
Get the head's participation in other legal entities
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/head-participation \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200HeadParticipationResult
{
"head": "string",
"items": [
{
"active": true,
"address_area": "string",
"head": "string",
"id": 0,
"industry": "string",
"industry_code": "string",
"name": "string",
"registration_date": "2026-01-01T00:00:00Z",
"registration_number": "string",
"role": "current",
"size": "string",
"sole_trader": true,
"staff_number": "string"
}
],
"total_count": 0
}GET/api/v2/{country}/companies/{id}/licenses
Get company licenses
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/licenses \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200LicensesResult
{
"items": [
{
"expiry_date": "2026-01-01T00:00:00Z",
"id": "string",
"issued_by": "string",
"issued_date": "2026-01-01T00:00:00Z",
"name": "string",
"number": "string",
"status": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/news
Get company news
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/news \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200NewsResult
{
"items": [
{
"link": "string",
"pub_date": "string",
"source": "string",
"source_link": "string",
"title": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/property
Get company property profile (land / real estate / vehicles)
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/property \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200PropertyResult
{
"currency": "string",
"items": [
{
"by_year": [
{
"count": 0,
"sum": 0,
"year": 0
}
],
"kind": "land",
"present": true,
"total_sum": 0
}
],
"present_count": 0,
"total_sum": 0
}GET/api/v2/{country}/companies/{id}/relations
Get company relations graph
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/relations \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200RelationsResult
{
"edges": [
{
"source_id": 0,
"target_id": 0,
"type": "string",
"types": [
"string"
]
}
],
"nodes": [
{
"id": 0,
"name": "string",
"registration_number": "string",
"type": "string"
}
]
}GET/api/v2/{country}/companies/{id}/risks
Get company risk profile
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/risks \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200RisksResult
{
"items": [
{
"active": true,
"category": "string",
"description": "string",
"details": [
{
"court_decision": "string",
"created_at": "string",
"date": "string",
"debt": "string",
"name": "string",
"penalty": "string",
"penny": "string",
"reason": "string",
"start_date": "string",
"sum": "string",
"ugd": "string",
"updated_at": "string",
"url": "string"
}
],
"severity": "low",
"source": "string",
"subject_name": "string",
"subject_type": "head",
"title": "string"
}
],
"page": 0,
"per_page": 0,
"score": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/rivals
Get company rivals
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/rivals \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200RivalsResult
{
"items": [
{
"active": true,
"address_area": "string",
"address_full": "string",
"employee_count": "string",
"extra": {},
"head": "string",
"id": 0,
"industry": "string",
"industry_code": "string",
"legal_form": "string",
"name": "string",
"registration_date": "2026-01-01T00:00:00Z",
"registration_number": "string",
"size": "string",
"status": "string",
"status_code": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/tax/estimated-profit
Get taxable profit estimated from corporate income tax
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/tax/estimated-profit \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200EstimatedProfitResult
{
"items": [
{
"currency": "string",
"profit": 0,
"rate": 0,
"tax": 0,
"year": 0
}
]
}GET/api/v2/{country}/companies/{id}/tax/payments
Get company tax payments
Parameters
| countryrequired | path · string | |
| idrequired | path · string | |
| page | query · integer | |
| per_page | query · integer | |
| sort_by | query · string | |
| sort_order | query · string | |
| year_from | query · integer | |
| year_to | query · integer | |
| kbk | query · string | Budget-classification code — return only payments under this code |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/tax/payments \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200TaxPaymentsResult
{
"items": [
{
"amount": 0,
"category": "string",
"category_id": "string",
"currency": "string",
"date": "2026-01-01T00:00:00Z",
"extra": {},
"status": "string",
"tax_authority": "string",
"tax_authority_code": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/companies/{id}/tax/payments/meta
Get aggregated tax payment metadata
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/tax/payments/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200TaxPaymentsMeta
{
"by_category": [
{
"code": "string",
"count": 0,
"name": "string",
"sum": 0
}
],
"by_month": [
{
"count": 0,
"month": 0,
"sum": 0,
"year": 0
}
],
"by_status": [
{
"count": 0,
"pay_status": "string",
"sum": 0
}
],
"by_type": [
{
"code": "string",
"count": 0,
"name": "string",
"name_kz": "string",
"sum": 0
}
],
"by_year": [
{
"count": 0,
"sum": 0,
"year": 0
}
],
"total_count": 0,
"total_sum": 0
}GET/api/v2/{country}/companies/{id}/tax/summary
Get company tax summary
Parameters
| countryrequired | path · string | |
| idrequired | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/tax/summary \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200TaxSummaryResult
{
"items": [
{
"currency": "string",
"fine": 0,
"penalty": 0,
"total": 0,
"vat_refund": 0,
"year": 0
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}Bulk
GET/api/v2/batches
List batch jobs (all countries)
Parameters
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/batches \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200BatchListGlobalResult
{
"items": [
{
"completed_at": "2026-01-01T00:00:00Z",
"created_at": "2026-01-01T00:00:00Z",
"failed_items": 0,
"id": 0,
"name": "string",
"processed_items": 0,
"status": "string",
"total_items": 0
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}GET/api/v2/{country}/batches
List batch jobs
Parameters
| countryrequired | path · string | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/batches \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200BatchListResult
{
"items": [
{
"completed_at": "2026-01-01T00:00:00Z",
"created_at": "2026-01-01T00:00:00Z",
"failed_items": 0,
"id": 0,
"name": "string",
"processed_items": 0,
"status": "pending",
"total_items": 0
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}POST/api/v2/{country}/batches
Create a batch verification job
Parameters
| countryrequired | path · string |
curl -X POST https://api.safedeal.kz/api/v2/kz/batches \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200BatchJob
{
"completed_at": "2026-01-01T00:00:00Z",
"created_at": "2026-01-01T00:00:00Z",
"failed_items": 0,
"id": 0,
"name": "string",
"processed_items": 0,
"status": "pending",
"total_items": 0
}GET/api/v2/{country}/batches/{id}
Get batch job status
Parameters
| countryrequired | path · string | |
| idrequired | path · integer |
curl https://api.safedeal.kz/api/v2/kz/batches/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200BatchJob
{
"completed_at": "2026-01-01T00:00:00Z",
"created_at": "2026-01-01T00:00:00Z",
"failed_items": 0,
"id": 0,
"name": "string",
"processed_items": 0,
"status": "pending",
"total_items": 0
}GET/api/v2/{country}/batches/{id}/results
Get batch job results
Parameters
| countryrequired | path · string | |
| idrequired | path · integer | |
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/kz/batches/523302/results \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Response body200BatchResultsResponse
{
"items": [
{
"company": {
"active": true,
"address": {
"city": "string",
"full": "string",
"postal_code": "string",
"region": "string",
"street": "string"
},
"country_code": "string",
"created_at": "2026-01-01T00:00:00Z",
"employee_count": "string",
"extra": {},
"full_name": "string",
"head": {
"name": "string",
"position": "string"
},
"id": 0,
"identifiers": [
{
"code": "string",
"value": "string"
}
],
"industry_code": "string",
"industry_codes": [
"string"
],
"industry_name": "string",
"legal_form": "string",
"name": "string",
"name_local": "string",
"old_heads": [
"string"
],
"paid": true,
"registration_date": "2026-01-01T00:00:00Z",
"registration_number": "string",
"roles": "string",
"size": "string",
"status": "string",
"status_code": "string",
"updated_at": "2026-01-01T00:00:00Z"
},
"company_id": 0,
"contracts_count": 0,
"court_cases_count": 0,
"error_message": "string",
"finance": {
"currency": "string",
"expense": 0,
"extra": {},
"profit": 0,
"revenue": 0,
"type": "string",
"year": 0
},
"licenses_count": 0,
"registration_number": "string",
"risks": [
{
"active": true,
"category": "string",
"description": "string",
"details": [
{}
],
"severity": "low",
"source": "string",
"subject_name": "string",
"subject_type": "head",
"title": "string"
}
],
"status": "string"
}
],
"page": 0,
"per_page": 0,
"total_count": 0
}