Получение откликов
GET /vacancy-responses
Метод возвращает отклики компании из токена, не отнесённые к неподходящим по портрету вакансии. Ответ содержит данные кандидата и текущий статус; отдельные поля могут быть null.
curl --get 'https://openapi.uhead.ru/prod/external/v1/vacancy-responses' \
--header "Authorization: Bearer $UHEAD_API_TOKEN" \
--data-urlencode 'vacancy_id=101' \
--data-urlencode 'created_at_from=2026-10-27T00:00:00+03:00' \
--data-urlencode 'page=1' \
--data-urlencode 'limit=100'Фильтры
| Параметр | Описание |
|---|---|
| vacancy_id | ID вакансии uhead, положительное целое число. |
| status_id | ID статуса отклика, положительное целое число. |
| created_at_from / created_at_to | Границы даты создания в формате date-time. Передавайте часовой пояс явно. |
| page / limit | Номер страницы от 1; размер страницы от 1 до 100, по умолчанию 20. |
Данные ответа
Ответ содержит items и pagination с полями page, limit, total. У отклика есть id, vacancy_id, status_id и created_at; также могут возвращаться название вакансии, имя, фамилия, отчество, возраст, телефон, регион, опыт, зарплатные ожидания и сопроводительное письмо.
Не подставляйте собственные фиксированные ID статусов. Используйте значения своей компании и сохраняйте ID отклика uhead для защиты от повторного импорта.
Организация синхронизации
Читайте выдачу постранично и сохраняйте записи по уникальному id отклика. Для периодической загрузки новых откликов используйте фильтры created_at_from и created_at_to с небольшим пересечением интервалов.
Фильтр даты относится к созданию отклика. Он не является фильтром обновлений: чтобы отслеживать изменения статусов старых откликов, повторно перечитывайте нужный период.
Методы и параметры описаны по публичной спецификации Open API uhead. Открыть справочник Open API