API Документация
REST API для интеграции проверки контрагентов Казахстана в ваши системы
Аутентификация
Все запросы к API требуют передачи API ключа в заголовке
x-api-key: "{ваш_api_ключ}"
API ключ можно получить в профиле пользователя
Коды ошибок
| Код | Описание |
|---|---|
| 400 | Некорректный запрос. Проверьте параметры. |
| 401 | Не авторизован. Проверьте API ключ. |
| 403 | Доступ запрещён. Недостаточно прав или исчерпан лимит. |
| 404 | Ресурс не найден. Проверьте URL и параметры. |
| 451 | Доступ к данным ограничен по требованию законодательства. |
| 429 | Слишком много запросов. Подождите перед повторной попыткой. |
| 500 | Внутренняя ошибка сервера. Попробуйте позже. |
Rate Limits
Лимиты зависят от вашего тарифного плана. Подробности в личном кабинете или обратитесь в поддержку.
Посмотреть тарифыPOST
Поиск контрагентов
Расширенный поиск компаний и ИП по различным критериям с фильтрами
POST https://api.safedeal.kz/api/v1/core/search/advancedQuery Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | required | Поисковый запрос (название компании, БИН, ИИН) |
| page | integer | 1 | Номер страницы |
| per_page | integer | 20 | Количество результатов на странице |
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
| area | string[] | optional | Фильтр по областям |
| active | boolean[] | optional | Статус активности |
| start_date | string | optional | Дата регистрации от (YYYY-MM-DD) |
| end_date | string | optional | Дата регистрации до (YYYY-MM-DD) |
| industry_code | string | optional | Код отрасли (ОКЭД) |
| stuff_number | string | optional | Количество сотрудников |
| size | string | optional | Размер предприятия |
| legal_form | string | optional | Организационно-правовая форма |
Examples
curl -X POST "https://api.safedeal.kz/api/v1/core/search/advanced?query=павлодар&page=1&per_page=20" \ -H "x-api-key: your_api_key_here" \ -H "Content-Type: application/json" \ -d '{ "area": ["Павлодарская область"], "active": [true], "start_date": "2020-01-01", "end_date": "2023-12-31", "industry_code": "19201", "stuff_number": "от 1001 до 999999 чел." }'
Response200 OK
{
"items": [
{
"id": 198765,
"unique_id": "002230000789",
"unique_key": "БИН",
"name": "ТОО \"ЭНЕРГОПРОМ ПАВЛОДАР\"",
"registration_date": "2021-03-12T06:00:00+06:00",
"industry_code": "19201",
"industry": "Производство продуктов нефтепереработки",
"size": "Крупные предприятия",
"staff_number": "от 1001 до 999999 чел.",
"address_full": "Павлодарская область, г. Экибастуз, ул. Промышленная, д. 45",
"address_area": "Павлодарская область",
"head": "Калиев Арман Ерланович",
"active": true
}
],
"total": 68000,
"page": 1
}GET
Детальная информация по БИН
Получение полной информации о компании или ИП по БИН/ИИН
GET https://api.safedeal.kz/api/v1/core/{unique_id}/binPath Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| unique_id | string | required | БИН или ИИН компании |
Examples
curl -X GET "https://api.safedeal.kz/api/v1/core/930440000929/bin" \ -H "x-api-key: your_api_key_here"
Response200 OK
{
"id": 99999,
"unique_id": "930440000929",
"unique_key": "БИН",
"name": "ТОО \"КАЗТЕХСЕРВИС 2011\"",
"full_name": "ТОВАРИЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"КАЗТЕХСЕРВИС\"",
"registration_date": "2017-03-15T00:00:00Z",
"industry_code": "62010",
"industry": "Разработка программного обеспечения",
"size": "Средние предприятия",
"staff_number": "51-100",
"address_full": "г. Астана, пр. Мангилик Ел, д. 55, офис 307",
"address_area": "г. Астана",
"head": "Нурбек Айдосов",
"active": true,
"status": "Зарегистрирован",
"vat_payer": true,
"risks": {
"wrong_address": {
"name": "Отсутствует по юридическому адресу",
"found": false,
"source": "Комитет государственных доходов",
"value": null
},
"tax_payer": {
"name": "Налоговая задолженность свыше 150 МРП",
"found": true,
"source": "Комитет государственных доходов",
"value": "245 МРП"
}
},
"phone": [
{
"type": "phone",
"contact": "+7 (7172) 555 123"
}
],
"email": [
{
"type": "email",
"contact": "info@kaztechservice.kz"
}
]
}GET
Информация о руководителе
Получение информации о компаниях, где указанное лицо является руководителем
GET https://api.safedeal.kz/api/v1/core/{id}/headPath Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | required | ID компании в системе SafeDeal |
Examples
curl -X GET "https://api.safedeal.kz/api/v1/core/671236/head" \ -H "x-api-key: your_api_key_here"
Response200 OK
{
"head": "Балтабаев Ануар Шекербаевич",
"items": [
{
"id": 277710,
"unique_id": "739204186517",
"name": "ТОО \"БАЙТЕРЕК ОНЛАЙН БИЗНЕС\"",
"registration_date": "2011-04-04T06:00:00+06:00",
"industry_code": "24440",
"industry": "Производство меди",
"size": "Крупные предприятия",
"staff_number": "от 1001 до 999999 чел.",
"address_area": "Область Ұлытау",
"head": "Балтабаев Ануар Шекербаевич",
"sole_trader": false
},
{
"id": 467734,
"unique_id": "482916305724",
"name": "ТОО \"АЛТЫНАР КАПИТАЛ 2040\"",
"registration_date": "2015-02-12T06:00:00+06:00",
"industry_code": "68201",
"industry": "Аренда и управление собственной недвижимостью",
"size": "Малые предприятия",
"staff_number": "от 0 до 5 чел.",
"address_area": "г.Алматы",
"head": "Балтабаев Ануар Шекербаевич",
"sole_trader": false
}
],
"total": 2,
"sole_trader": false
}GET
Информация о сотрудниках
Получение списка сотрудников компании по ID в системе
GET https://api.safedeal.kz/api/v1/core/{id}/employeesPath Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | required | ID компании в системе SafeDeal |
Examples
curl -X GET "https://api.safedeal.kz/api/v1/core/671236/employees" \ -H "x-api-key: your_api_key_here"
Response200 OK
{
"items": [
{
"name": "Сагындыкова Аяулым Муратовна",
"role": "Сотрудник",
"start_date": "2019-03-15 09:32:18"
},
{
"name": "Турсынов Бекзат Муратулы",
"role": "Руководитель",
"start_date": "2021-01-18 10:10:27"
}
],
"total": 8
}