РАЗРАБОТЧИКАМ

Один реестр через API

Country-agnostic схема: тот же ответ для любой юрисдикции. Базовый URL — api-v2.safedeal.kz.

Скачать OpenAPI

Аутентификация

Все запросы требуют ключ API в заголовке X-API-Key. Ключ создаётся в личном кабинете.

curl https://api-v2.safedeal.kz/api/v2/kz/companies/523302 \
  -H "X-API-Key: $SAFEDEAL_API_KEY"

Базовый URL

Все эндпоинты монтируются под api-v2.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С По запросу

Проверка контрагентов из учётной системы по БИН.

Как это работает

  1. 1Получите API-ключ в личном кабинете (Профиль → «API»).
  2. 2На событие в вашей системе (добавили компанию по БИН) вызовите наше API.
  3. 3Запишите ответ (риски / финансы / статус / ссылку на PDF) в поля карточки.
curl https://api-v2.safedeal.kz/api/v2/kz/companies/523302 \
  -H "X-API-Key: $SAFEDEAL_API_KEY"

Битрикс24 — пошагово

Что получаете: проверку контрагента прямо в карточке компании или сделки — по БИН подтягиваются риски, финансовое состояние и статус из SafeDeal.

  1. 1В SafeDeal скопируйте API-ключ (Профиль → «API»).
  2. 2В Битрикс24 создайте входящий вебхук или локальное приложение (Разработчикам → Другое → «Входящий вебхук» / «Локальное приложение») с доступом к CRM.
  3. 3Настройте робота или бизнес-процесс в CRM: на добавление/изменение компании возьмите БИН из поля карточки и вызовите наше API (пример ниже).
  4. 4Разберите JSON-ответ и запишите значения в поля карточки (риск, статус, дата регистрации) либо покажите ссылку на PDF-отчёт.
# Битрикс дёргает наш API по идентификатору компании
curl https://api-v2.safedeal.kz/api/v2/kz/companies/523302 \
  -H "X-API-Key: $SAFEDEAL_API_KEY"

Идентификатор компании находится поиском по БИН (см. справочник ниже); полный список полей ответа — в разделах справочника (компания, риски, финансы, налоги, суды и др.). Готовое приложение для Битрикс-маркетплейса — по запросу.

Нужна помощь с интеграцией или готовый коннектор под вашу систему?

info@safedeal.kzTelegram

Meta

GET/api/v2/{country}/features

Get available features for the country

Параметры
countryобязательныйpath · string
curl https://api-v2.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-v2.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",
        "value": "string"
      }
    ],
    "sizeClasses": [
      {
        "code": "string",
        "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-v2.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_numberquery · string
industry_codequery · string
curl https://api-v2.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
areaquery · string
industry_codequery · string
pagequery · integer
per_pagequery · integer
curl https://api-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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-v2.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-v2.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-v2.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-v2.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-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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
directionquery · string
pagequery · integer
per_pagequery · integer
curl https://api-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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",
      "type": "string"
    }
  ],
  "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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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-v2.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
pagequery · integer
per_pagequery · integer
typequery · string
curl https://api-v2.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-v2.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-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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-v2.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-v2.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
pagequery · integer
per_pagequery · integer
statusquery · string
rolequery · string
year_fromquery · integer
year_toquery · integer
curl https://api-v2.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"
    }
  ],
  "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-v2.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-v2.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-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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-v2.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-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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-v2.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-v2.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-v2.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-v2.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-v2.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-v2.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
pagequery · integer
per_pagequery · integer
sort_byquery · string
sort_orderquery · string
year_fromquery · integer
year_toquery · integer
kbkquery · stringBudget-classification code — return only payments under this code
curl https://api-v2.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-v2.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-v2.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)

Параметры
pagequery · integer
per_pagequery · integer
curl https://api-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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-v2.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-v2.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
pagequery · integer
per_pagequery · integer
curl https://api-v2.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
}