Skip to content
Для ИИ NEW Мои токены Поддержка
Чат для вопросов по API Мгновенно ответим на ваши вопросы
api@ati.su Электронная почта техподдержки
Тикетная система Оставить заявку на отдел "Консультанты по интеграции (API)"
api.ati.su - заказы, торги, площадки Наш телеграм-канал
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
Отменить
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.

OpenAPI · Markdown

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

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

Групповое получение краткой информации о фирмаx по email. Доступно только платным пользователям. Для пользователя без оплаты после базовой валидации списка возвращается HTTP 403 с телом `ErrorResponse` (`reason` = «Поиск по контактным данным доступен только платным пользователям.») до проверки batch/дневного лимита и поиска. Несуществующие адреса у бесплатного не отличаются от запрета. Для платного при отсутствии совпадений — HTTP 200 с пустым массивом. Публичные URL-алиасы: `/v1.0/search/summaries-emails`, `/v1.0/firms/search/summaries-emails`, `/v1.0/extendedsearch/summaries-emails`.
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":[...]
{...}
"tf_firm_color":"Green",
"tf_account_color":"Green",
"tf_has_signals":true,
"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,
"leveled_claims_count":0,
"recommendations_count":0,
"inn":"string",
"ogrn":"string",
"kpp":"string",
"okpo":"string",
"affiliated_firms":[...],
{...}
"tf_firm_color":"Green",
"tf_has_signals":true,
"firm_name":"string",
"inn":"string"
}
],
"negative_points_sum":0,
"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":[...]
{...}
"tf_firm_color":"Green",
"tf_account_color":"Green",
"tf_has_signals":true,
"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,
"leveled_claims_count":0,
"recommendations_count":0,
"inn":"string",
"ogrn":"string",
"kpp":"string",
"okpo":"string",
"affiliated_firms":[...],
{...}
"tf_firm_color":"Green",
"tf_has_signals":true,
"firm_name":"string",
"inn":"string"
}
],
"negative_points_sum":0,
"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 и пустой список.

Получение краткой информации о фирме по номеру телефона или ИНН. Поиск по телефону доступен только платным пользователям: для пользователя без оплаты возвращается HTTP 403 с телом `ErrorResponse` (`reason` = «Поиск по контактным данным доступен только платным пользователям.») до проверки лимита и Elastic, независимо от наличия номера в индексе (существование номера не утекает). Поиск по ИНН доступен и бесплатным пользователям. Для платного при отсутствии фирм по телефону/ИНН — HTTP 404. Публичные URL-алиасы: `/v1.0/search/summary`, `/v1.0/firms/search/summary`, `/v1.0/extendedsearch/summary`.
get /v1.0/firms/search/summary
Параметры
Параметр Тип Расположение Описание
phone string query
Номер телефона Пример: +7-495-000-00-00
inn string query
ИНН Пример: 7707083893
Запрос
Пример запроса 
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

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

leveled_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

Сигнал «Светофора» по основной организации аккаунта ATI.SU. Учитывает сведения об этой организации; общий сигнал с учётом связанных фирм возвращается в tf_account_color.

Возможные строковые значения (регистр имеет значение):

  • Green — найдены положительные сведения о хозяйственной деятельности; предупреждающих и критических сигналов нет;
  • Yellow — есть сведения, требующие дополнительной проверки, например изменение данных организации или недостаток информации;
  • Red — есть критические сведения, например прекращение деятельности, банкротство или ликвидация;
  • White — данные получены, но зелёных, жёлтых и красных сигналов нет;
  • NoData — «Светофор» вернул статус отсутствия данных об организации.

В публичном поиске ключ tf_firm_color отсутствует у пользователей без платного доступа ATI.SU. Если ключ присутствует, значение null означает, что сведения о цвете не получены. Отсутствие ключа, null и строка NoData — разные состояния ответа.

tf_account_color: null,string

Общий сигнал «Светофора» по аккаунту ATI.SU с учётом основной организации и связанных фирм. Может отличаться от tf_firm_color, который относится только к основной организации.

Возможные строковые значения (регистр имеет значение):

  • Green — найдены положительные сведения о хозяйственной деятельности; предупреждающих и критических сигналов нет;
  • Yellow — есть сведения, требующие дополнительной проверки, в том числе сведения о связанных фирмах;
  • Red — есть критические сведения, например прекращение деятельности, банкротство или ликвидация;
  • White — данные получены, но зелёных, жёлтых и красных сигналов нет;
  • NoData — «Светофор» вернул статус отсутствия данных об аккаунте.

В публичном поиске ключ tf_account_color отсутствует у пользователей без платного доступа ATI.SU. Если ключ присутствует, значение null означает, что сведения о цвете не получены. Отсутствие ключа, null и строка NoData — разные состояния ответа. Признак tf_has_signals равен true для Green, Yellow и Red.

tf_has_signals: boolean

Признак наличия сигналов «Светофора» на уровне аккаунта ATI.SU с учётом основной организации и связанных фирм. Значение true соответствует цвету аккаунта Green, Yellow или Red; false — цвету White, NoData или отсутствию полученных сведений о цвете аккаунта. В публичном поиске признак доступен и пользователям без платного доступа, у которых ключ tf_account_color отсутствует.

registration_date: date-time

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

contact_info_changed: date-time

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

last_month_active_days: int32

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

verified_trucks: int32

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

}]
Пример
[...]
{...}
"tf_firm_color":"Green",
"tf_account_color":"Green",
"tf_has_signals":true,
"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,
"leveled_claims_count":0,
"recommendations_count":0,
"inn":"string",
"ogrn":"string",
"kpp":"string",
"okpo":"string",
"affiliated_firms":[...],
{...}
"tf_firm_color":"Green",
"tf_has_signals":true,
"firm_name":"string",
"inn":"string"
}
],
"negative_points_sum":0,
"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":"Произошла ошибка при получении данных"
}