ӘЗІРЛЕУШІЛЕРГЕ
API арқылы бірыңғай тізілім
Country-agnostic схема: кез келген юрисдикция үшін бірдей жауап. Базалық URL — api.safedeal.kz.
Аутентификация
Барлық сұраныстар X-API-Key тақырыбында API кілтін талап етеді. Кілт жеке кабинетте жасалады.
curl https://api.safedeal.kz/api/v2/kz/companies/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Базалық URL
Барлық эндпоинттер api.safedeal.kz астында орналасады. Жолдағы kz — ел коды (мысалы, kz).
Қателер
Қателер RFC 9457 (problem+json) форматында қайтарылады: type, title, status, detail өрістері. HTTP коды статусты көрсетеді.
{ "type", "title", "status", "detail" }Беттеу
Тізімдік эндпоинттер page және per_page қабылдайды; жауапта total_count бар.
Интеграциялар
SafeDeal — ең алдымен API. Контрагентті БСН/ЖСН бойынша тексеруді кез келген жүйеңізге енгізуге болады: CRM, есеп бағдарламасы, кестелер немесе жеке өніміңіз. Деректер — тәуекелдер, қаржы, мәртебе, PDF есеп — сайтқа қолмен кірмей-ақ автоматты түрде қайтарылады.
REST API Қолжетімді
Кез келген өнімге тікелей интеграция — қосылудың негізгі тәсілі.
Excel / Google Sheets Қолжетімді
БСН/ЖСН тізімін жаппай тексеру және есептерді кесте түрінде жүктеп алу.
Битрикс24 Сұраныс бойынша
Контрагентті тікелей CRM картасында тексеру. Коннектор біздің API негізінде.
amoCRM Сұраныс бойынша
Мәмілелер мен компанияларды SafeDeal деректері және тәуекелдерімен байыту.
1С Сұраныс бойынша
Есеп жүйесінен контрагенттерді БСН бойынша тексеру.
Қалай жұмыс істейді
- 1API кілтін жеке кабинетте алыңыз (Профиль → «API»).
- 2Жүйеңіздегі оқиға бойынша (БСН арқылы компания қосылғанда) біздің API-ды шақырыңыз.
- 3Жауапты (тәуекелдер / қаржы / мәртебе / PDF сілтемесі) карта өрістеріне жазыңыз.
curl https://api.safedeal.kz/api/v2/kz/companies/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Битрикс24 — қадам бойынша
Не аласыз: контрагентті тікелей компания немесе мәміле картасында тексеру — БСН бойынша SafeDeal-ден тәуекелдер, қаржылық жағдай және мәртебе тартылады.
- 1SafeDeal-де API кілтін көшіріңіз (Профиль → «API»).
- 2Битрикс24-те CRM-ге қолжетімділігі бар кіріс вебхук немесе жергілікті қосымша жасаңыз (Әзірлеушілерге → Басқа → «Кіріс вебхук» / «Жергілікті қосымша»).
- 3CRM-де роботты немесе бизнес-процесті баптаңыз: компанияны қосқанда/өзгерткенде карта өрісінен БСН алып, біздің API-ды шақырыңыз (мысал төменде).
- 4JSON жауабын талдап, мәндерді карта өрістеріне жазыңыз (тәуекел, мәртебе, тіркеу күні) немесе PDF есепке сілтеме көрсетіңіз.
# Битрикс біздің API-ды компания идентификаторы бойынша шақырады curl https://api.safedeal.kz/api/v2/kz/companies/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Компания идентификаторы БСН бойынша іздеу арқылы табылады (төмендегі анықтаманы қараңыз); жауап өрістерінің толық тізімі анықтама бөлімдерінде (компания, тәуекелдер, қаржы, салықтар, соттар және т.б.). Битрикс-маркетплейске арналған дайын қосымша — сұраныс бойынша.
Интеграцияға көмек немесе жүйеңізге дайын коннектор керек пе?
Meta
GET/api/v2/{country}/features
Get available features for the country
Параметрлер
| countryміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/features \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200Features
{
"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
Параметрлер
| countryміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/info \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200CountryInfo
{
"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
Параметрлер
| countryміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/stats \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200Stats
{
"companies": 0,
"jurisdictions": 0,
"risk_checks": 0
}Search & discovery
GET/api/v2/{country}/alternatives
Get alternative companies
Параметрлер
| countryміндетті | 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"
Жауап денесі200AlternativesResult
{
"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
Параметрлер
| countryміндетті | 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"
Жауап денесі200CatalogResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| qміндетті | 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"
Жауап денесі200SearchResult
{
"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
Параметрлер
| countryміндетті | path · string |
curl -X POST https://api.safedeal.kz/api/v2/kz/search/advanced \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200SearchResult
{
"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
Параметрлер
| countryміндетті | path · string |
curl -X POST https://api.safedeal.kz/api/v2/kz/tenders/search \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200TenderSearchResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200CompanyCard
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/access \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200AccessInfo
{
"paid": true
}GET/api/v2/{country}/companies/{id}/accounting
Get company accounting report
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/accounting \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200AccountingReport
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200AccreditationsResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200AffiliationsResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200ArrestsResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200BankAccountsResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/branches \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200BranchesResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200CertificatesResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/certificates/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200CertificatesMeta
{
"counts": {},
"total": 0
}GET/api/v2/{country}/companies/{id}/contacts
Get company contact information
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/contacts \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200ContactsResult
{
"emails": [
"string"
],
"phones": [
"string"
],
"total_count": 0,
"websites": [
"string"
]
}GET/api/v2/{country}/companies/{id}/contracts
Get company procurement contracts
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200ContractsResult
{
"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)
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/contracts/by-year \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200ContractsByYear
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/contracts/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200ContractsMeta
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200CourtCasesResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/court-cases/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200CourtCasesMeta
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/court-cases/status \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200CourtWorkerStatus
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/employees \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200EmployeesInfo
{
"employees": [
{
"name": "string",
"position": "string"
}
]
}GET/api/v2/{country}/companies/{id}/events
Get company events
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200EventsResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/events/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200EventsMeta
{
"by_type": [
{
"count": 0,
"type": "string"
}
],
"total_count": 0
}GET/api/v2/{country}/companies/{id}/finances
Get company financial reports
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/finances \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200FinancesResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200FoundersResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/head-participation \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200HeadParticipationResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200LicensesResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/news \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200NewsResult
{
"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)
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/property \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200PropertyResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/relations \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200RelationsResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/risks \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200RisksResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/rivals \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200RivalsResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/tax/estimated-profit \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200EstimatedProfitResult
{
"items": [
{
"currency": "string",
"profit": 0,
"rate": 0,
"tax": 0,
"year": 0
}
]
}GET/api/v2/{country}/companies/{id}/tax/payments
Get company tax payments
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200TaxPaymentsResult
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/tax/payments/meta \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200TaxPaymentsMeta
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · string |
curl https://api.safedeal.kz/api/v2/kz/companies/523302/tax/summary \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200TaxSummaryResult
{
"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)
Параметрлер
| page | query · integer | |
| per_page | query · integer |
curl https://api.safedeal.kz/api/v2/batches \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200BatchListGlobalResult
{
"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
Параметрлер
| countryміндетті | 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"
Жауап денесі200BatchListResult
{
"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
Параметрлер
| countryміндетті | path · string |
curl -X POST https://api.safedeal.kz/api/v2/kz/batches \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200BatchJob
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | path · integer |
curl https://api.safedeal.kz/api/v2/kz/batches/523302 \ -H "X-API-Key: $SAFEDEAL_API_KEY"
Жауап денесі200BatchJob
{
"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
Параметрлер
| countryміндетті | path · string | |
| idміндетті | 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"
Жауап денесі200BatchResultsResponse
{
"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
}