Skip to content
Мои токены Поддержка
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
For LLMs and AI agents: canonical Markdown source of this documentation page (plain-text .md — fetch this URL to use the page content in tools and RAG). For LLMs and AI agents: developers documentation index in llms.txt format — ordered list of key documentation URLs for the developers section.

Поиск краткой информации о фирмах

Обращаем ваше внимание, что лимит на обращения к данным методам составляет 1000 запросов в день. При его превышении придёт ошибка 400 - “error”:“invalid_input_data”,“reason”:“Превышен лимит запросов.”

Групповое получение краткой информации о фирмаx по email
post /v1.0/firms/search/summaries-emails
Запрос
Модель
[string]
Пример запроса
curl 'https://api.ati.su/v1.0/firms/search/summaries-emails' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '["string"]'
Ответ
200 OK
Модель
[{...}]

Элемент результата поиска фирм по ключу.

key: null,string

Ключ

}]
Пример
[...]
{...}
"key":"string",
"value":[...]
{...}
"contact_names":[...],
"string"
],
"query_first_change_date":"1970-01-01T00:00:00Z",
"ati_id":"string",
"full_name":"string",
"firm_type":"string",
"firm_type_id":"string",
"location":{...},
"city_id":0,
"region_id":0,
"country_id":0,
"full_name":"string",
"short_name":"string",
"is_regional_center":false,
"city_size":0,
"fias_id":"00000000-0000-0000-0000-000000000000",
"attributes":0,
"city_name":"string",
"region_name":"string",
"country_name":"string",
"country_code_name":"string"
},
"address":"string",
"position_in_city":0,
"position_in_country":0,
"firm_documents":[...],
{...}
"link":"string",
"description":"string",
"creation_date":"1970-01-01T00:00:00Z"
}
],
"web_site":"string",
"info_reference":"string",
"passport_reference":"string",
"city":"string",
"score":0,
"bad_partner_mentions_count":0,
"claims_count":0,
"recommendations_count":0,
"inn":"string",
"ogrn":"string",
"kpp":"string",
"okpo":"string",
"affiliated_firms":[...],
{...}
"firm_name":"string",
"inn":"string",
"tf_firm_color":"string",
"tf_has_signals":false
}
],
"negative_points_sum":0,
"tf_firm_color":"string",
"tf_account_color":"string",
"tf_has_signals":false,
"registration_date":"1970-01-01T00:00:00Z",
"contact_info_changed":"1970-01-01T00:00:00Z",
"last_month_active_days":0,
"verified_trucks":0
}
]
}
]
400 Неверные входные данные.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"invalid_input_data",
"reason":"Неверные входные данные."
}
401 Не авторизован
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"un_authorized",
"reason":"Не авторизован"
}
403 Отсутствует разрешение.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"forbidden",
"reason":"Отсутствует разрешение."
}
500 Произошла ошибка во время выполнения запроса.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"internal_error",
"reason":"Произошла ошибка во время выполнения запроса."
}
503 Произошла ошибка при получении данных
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"external_service_error",
"reason":"Произошла ошибка при получении данных"
}

В методе можно передать за раз 10 адресов. При передаче большего количества - придёт ошибка 400 - “error”:“invalid_input_data”,“reason”:“Размер входного массива не должен превышать 10”. Если по переданным параметрам ничего не найдётся — будет возвращён код 200 и пустой список.

Групповое получение краткой информации о фирмаx по ИНН
post /v1.0/firms/search/summaries
Запрос
Модель
[string]
Пример запроса
curl 'https://api.ati.su/v1.0/firms/search/summaries' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '["string"]'
Ответ
200 OK
Модель
[{...}]

Элемент результата поиска фирм по ключу.

key: null,string

Ключ

}]
Пример
[...]
{...}
"key":"string",
"value":[...]
{...}
"ati_id":"string",
"full_name":"string",
"firm_type":"string",
"firm_type_id":"string",
"location":{...},
"city_id":0,
"region_id":0,
"country_id":0,
"full_name":"string",
"short_name":"string",
"is_regional_center":false,
"city_size":0,
"fias_id":"00000000-0000-0000-0000-000000000000",
"attributes":0,
"city_name":"string",
"region_name":"string",
"country_name":"string",
"country_code_name":"string"
},
"address":"string",
"position_in_city":0,
"position_in_country":0,
"firm_documents":[...],
{...}
"link":"string",
"description":"string",
"creation_date":"1970-01-01T00:00:00Z"
}
],
"web_site":"string",
"info_reference":"string",
"passport_reference":"string",
"city":"string",
"score":0,
"bad_partner_mentions_count":0,
"claims_count":0,
"recommendations_count":0,
"inn":"string",
"ogrn":"string",
"kpp":"string",
"okpo":"string",
"affiliated_firms":[...],
{...}
"firm_name":"string",
"inn":"string",
"tf_firm_color":"string",
"tf_has_signals":false
}
],
"negative_points_sum":0,
"tf_firm_color":"string",
"tf_account_color":"string",
"tf_has_signals":false,
"registration_date":"1970-01-01T00:00:00Z",
"contact_info_changed":"1970-01-01T00:00:00Z",
"last_month_active_days":0,
"verified_trucks":0
}
]
}
]
400 Неверные входные данные.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"invalid_input_data",
"reason":"Неверные входные данные."
}
401 Не авторизован
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"un_authorized",
"reason":"Не авторизован"
}
403 Отсутствует разрешение.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"forbidden",
"reason":"Отсутствует разрешение."
}
500 Произошла ошибка во время выполнения запроса.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"internal_error",
"reason":"Произошла ошибка во время выполнения запроса."
}
503 Произошла ошибка при получении данных
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"external_service_error",
"reason":"Произошла ошибка при получении данных"
}

В методе можно передать за раз 10 ИНН. При передаче большего количества - придёт ошибка 400 - “error”:“invalid_input_data”,“reason”:“Размер входного массива не должен превышать 10”. Если по переданным параметрам ничего не найдётся — будет возвращён код 200 и пустой список.

Получение краткой информации о фирме по номеру телефона или ИНН
get /v1.0/firms/search/summary
Запрос
Пример запроса
curl 'https://api.ati.su/v1.0/firms/search/summary' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 OK
Модель
[{...}]

Краткая информация о фирме с данными по контактам.

contact_names: [string]

Имена контактов

query_first_change_date: date-time

Даты первого добавления искомого параметра поиска (email, phone, inn)

ati_id: null,string

Код в АТИ.

full_name: null,string

Полное имя фирмы: Брэнд (Название фирмы, ОПФ)

firm_type: null,string

Профиль деятельности фирмы

firm_type_id: null,string

Идентификатор профиля деятельности фирмы

address: null,string

Адрес фирмы

position_in_city: int32

Место в рэйтинге по городу

position_in_country: int32

Место в рэйтинге по стране

web_site: null,string

Сайт фирмы

info_reference: null,string

Ссылка на карточку фирмы

passport_reference: null,string

Ссылка на паспорт фирмы

city: null,string

Город, в котором расположена фирма

score: double

Количество звезд фирмы. Если число отрицательно, то это красные звезды

bad_partner_mentions_count: int32

Количество упоминаний на форуме недобросовестных партнеров

claims_count: int32

Количество претензий от фирм

recommendations_count: int32

Количество рекомендаций от фирм

inn: null,string

Инн

ogrn: null,string

ОГРН

kpp: null,string

Код причины постановки на учет фирмы

okpo: null,string

Общероссийский классификатор предприятий и организаций

negative_points_sum: double

Сумма отрицательных баллов

tf_firm_color: null,string

Цвет фирмы в светофоре (Доступно только для платных пользователей)

tf_account_color: null,string

Цвет аккаунта в светофоре (Доступно только для платных пользователей)

tf_has_signals: boolean

Флаг о существовании любой информации о фирме в светофоре

registration_date: date-time

Дата регистрации на сайте, которая AddDate из firms.

contact_info_changed: date-time

Дата последних изменений в истории фирмы. (Доступно только для платных пользователей)

last_month_active_days: int32

Число дней со входами на сайт за последние 30 дней (Доступно только для платных пользователей).

verified_trucks: int32

Количество зарегистрированных ТС

}]
Пример
[...]
{...}
"contact_names":[...],
"string"
],
"query_first_change_date":"1970-01-01T00:00:00Z",
"ati_id":"string",
"full_name":"string",
"firm_type":"string",
"firm_type_id":"string",
"location":{...},
"city_id":0,
"region_id":0,
"country_id":0,
"full_name":"string",
"short_name":"string",
"is_regional_center":false,
"city_size":0,
"fias_id":"00000000-0000-0000-0000-000000000000",
"attributes":0,
"city_name":"string",
"region_name":"string",
"country_name":"string",
"country_code_name":"string"
},
"address":"string",
"position_in_city":0,
"position_in_country":0,
"firm_documents":[...],
{...}
"link":"string",
"description":"string",
"creation_date":"1970-01-01T00:00:00Z"
}
],
"web_site":"string",
"info_reference":"string",
"passport_reference":"string",
"city":"string",
"score":0,
"bad_partner_mentions_count":0,
"claims_count":0,
"recommendations_count":0,
"inn":"string",
"ogrn":"string",
"kpp":"string",
"okpo":"string",
"affiliated_firms":[...],
{...}
"firm_name":"string",
"inn":"string",
"tf_firm_color":"string",
"tf_has_signals":false
}
],
"negative_points_sum":0,
"tf_firm_color":"string",
"tf_account_color":"string",
"tf_has_signals":false,
"registration_date":"1970-01-01T00:00:00Z",
"contact_info_changed":"1970-01-01T00:00:00Z",
"last_month_active_days":0,
"verified_trucks":0
}
]
400 Неверные входные данные.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"invalid_input_data",
"reason":"Неверные входные данные."
}
401 Не авторизован
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"un_authorized",
"reason":"Не авторизован"
}
403 Отсутствует разрешение.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"forbidden",
"reason":"Отсутствует разрешение."
}
404 Ресурс не найден
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"not_found",
"reason":"Ресурс не найден"
}
500 Произошла ошибка во время выполнения запроса.
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"internal_error",
"reason":"Произошла ошибка во время выполнения запроса."
}
503 Произошла ошибка при получении данных
Модель
{...}

Стандартный ответ с описанием ошибки

error: null,string

Код ошибки

reason: null,string

Описание ошибки

}
Пример
{...}
"error":"external_service_error",
"reason":"Произошла ошибка при получении данных"
}