Запрос предложений

Метод запроса предложений по полной анкете.

Формат запроса

POST /request-offers
Пример запроса
{
  "request_id": "123e4567-e89b-12d3-a456-426614174000",
  "ip_address": null,
  "client_info": {
    "last_name": "example",
    "first_name": "example",
    "middle_name": "example",
    "gender": "male",
    "marital_status": "divorced",
    "amount_of_children": 0,
    "education": "elementary",
    "contacts": {
      "phone_number": "example",
      "email": "user@example.com"
    },
    "documents": {
      "snils": "example",
      "inn": "example",
      "passport": {
        "number": "example",
        "series": "example",
        "birthday": "2025-01-01",
        "issued_at": "2025-01-01",
        "issuer": "example",
        "subdivision": "example",
        "birthplace": "example",
        "reg_address": "example",
        "reg_at": "2025-01-01",
        "reg_address_flat": "example",
        "res_address_flat": "example",
        "res_address": "example",
        "reg_address_fias_code": "00a77cd5-e431-46df-8832-f9f462c15205",
        "res_address_fias_code": "00a77cd5-e431-46df-8832-f9f462c15205"
      }
    },
    "employment": {
      "type": "employee",
      "start_date": "2025-01-01",
      "incomes": 0.5
    }
  },
  "amount": 0.5,
  "term": {
    "value": 0.5,
    "type": "day"
  },
  "loan_type": "pdl",
  "filter": [
    "no_additional_services"
  ],
  "personal_data_agree": [
    {
      "agreement_id": "example",
      "agreement_type": "personal_data_processing",
      "sign_date": "2025-01-01"
    }
  ],
  "identification": [
    {
      "is_passed": true,
      "identification_date": "2025-01-01",
      "identification_provider": "example",
      "identification_id": "example"
    }
  ],
  "props": {}
}

Параметр

Описание

Тип

Обязательно

Комментарий

amount

Сумма займа.

number

Да

client_info

Объект с информацией о клиенте.

ClientInfo

Да

loan_type

Тип продукта.

string

Да

Возможные значения:

  • pdl;
  • il.

request_id

Идентификатор запроса.

string

Да

UUID. Пример: 123e4567-e89b-12d3-a456-426614174000.

term

Срок займа.

Term

Да

filter

Массив фильтров клиента.

string[]

Нет

Возможные значения:

  • no_additional_services — без дополнительных услуг;
  • no_overpayment — без переплат.

identification

Объект с идентификациями клиента.

Identification

Нет

ip_address

IP‑адрес клиента.

string

Нет

personal_data_agree

Массив с данными о согласии об обработке персональных данных.

PersonalDataAgree

Нет

props

Опциональный объект для поддержания совместимости API.

object

Нет

ClientInfo

Параметр

Описание

Тип

Обязательно

Комментарий

contacts

Объект с контактами клиента.

Contacts

Да

documents

Объект с документами клиента.

Documents

Да

employment

Объект с данными о трудоустройстве.

Employment

Да

first_name

Имя.

string

Да

gender

Пол.

string

Да

Возможные значения:

  • male;
  • female.

last_name

Фамилия.

string

Да

marital_status

Семейный статус.

string

Да

Возможные значения:

  • divorced;
  • married;
  • single;
  • widow.

amount_of_children

Количество детей

integer

Нет

0 — без детей.

education

Образование.

string

Нет

Возможные значения:

  • elementary;
  • secondary;
  • incomplete_higher;
  • higher.

middle_name

Отчество.

string

Нет

Contacts

Параметр

Описание

Тип

Обязательно

Комментарий

email

Электронная почта.

string

Да

Формат: email. Пример: user@example.com.

phone_number

Номер телефона.

string

Да

Формат: ^9\d{9}$.

Documents

Параметр

Описание

Тип

Обязательно

Комментарий

inn

ИНН.

string

Да

Формат: ^(([0-9]{12})|([0-9]{10}))?$.

passport

Паспорт РФ.

Passport

Да

snils

СНИЛС.

string

Да

Формат: ^(?:[- ]*\d){11}$.

Passport

Параметр

Описание

Тип

Обязательно

Комментарий

birthday

Дата рождения.

string

Да

date. Формат: yyyy-mm-dd. Пример: 2025-01-01.

birthplace

Место рождения.

string

Да

issued_at

Дата выдачи документа.

string

Да

date. Формат: yyyy-mm-dd. Пример: 2025-01-01.

issuer

Кем выдан.

string

Да

number

Номер паспорта.

string

Да

reg_address

Адрес регистрации.

string

Да

reg_at

Дата регистрации.

string

Да

date. Формат: yyyy-mm-dd. Пример: 2025-01-01.

res_address

Адрес проживания.

string

Да

series

Серия паспорта.

string

Да

subdivision

Код подразделения.

string

Да

Формат: ^\d{3}-\d{3}$.

reg_address_fias_code

ФИАС‑код регистрации (до дома).

string

Нет

Пример: 00a77cd5-e431-46df-8832-f9f462c15205.

reg_address_flat

Квартира в адресе регистрации.

string

Нет

res_address_fias_code

ФИАС‑код проживания (до дома).

string

Нет

Пример: 00a77cd5-e431-46df-8832-f9f462c15205.

res_address_flat

Квартира в адресе проживания.

string

Нет

Employment

Параметр

Описание

Тип

Обязательно

Комментарий

incomes

Ежемесячный доход.

number

Да

start_date

Дата начала работы.

string

Да

date. Шаблон: yyyy-mm-dd. Пример: 2025-01-01.

type

Тип занятости.

string

Да

Возможные значения:

  • employee;
  • business_owner;
  • self_employed;
  • pensioner;
  • unemployed;
  • preferential;
  • maternity;
  • student;
  • housewife;
  • other.

Term

Параметр

Описание

Тип

Обязательно

Комментарий

type

Тип периодичности.

string

Да

Возможные значения:

  • day — день;
  • month — месяц;
  • week — неделя;
  • year — год.

value

Срок / Сумма в рублях / Процентная ставка.

number

Да

Identification

Параметр

Описание

Тип

Обязательно

Комментарий

identification_date

Дата прохождения УПРИД.

string

Нет

date. Формат: yyyy-mm-dd. Пример: 2025-01-01.

identification_id

ID сессии у провайдера.

string

Нет

identification_provider

Провайдер УПРИД.

string

Нет

is_passed

УПРИД пройден.

boolean

Нет

PersonalDataAgree

Параметр

Описание

Тип

Обязательно

Комментарий

agreement_id

ID согласия.

string

Да

agreement_type

Тип согласия.

string

Да

Возможные значения:

  • personal_data_processing — согласие на обработку персональных данных;
  • credit_score_access — согласие на доступ в БКИ.

sign_date

Дата подписания соглашения.

string

Да

date. Формат: yyyy-mm-dd. Пример: 2025-01-01.

Успешный ответ

200 OK
Формат ответа
{
  "request_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2025-01-01T00:00:00Z",
  "status": "success",
  "reason": "example"
}

Параметр

Описание

Тип

Обязательно

Комментарий

created_at

Дата и время генерации предложений.

string

Да

date-time. Формат: yyyy-mm-ddTHH:mm:ssZ. Пример: 2025-01-01T00:00:00Z.

request_id

Идентификатор запроса.

string

Да

UUID. Пример: 123e4567-e89b-12d3-a456-426614174000.

status

Статус предложения.

string

Да

Возможные значения:

  • success — предложение успешно;
  • blacklist — предложение отклонено, пользователь находится в черном списке;
  • client_moratorium — предложение отклонено из‑за моратория на выдачу займов;
  • rejected — предложение отклонено партнером;
  • client_has_active_application — предложение отклонено, у клиента уже имеется активная заявка.

reason

Причина отказа.

string

Нет

Стандартные коды ответов

Остались вопросы?

Внимание

Специалисты отдела клиентского сервиса могут вас проконсультировать только по кампаниям того логина, с которого вы обращаетесь. Логин можно увидеть, если открыть ya.ru на соседней вкладке браузера. Специалист получит доступ к вашим данным только при обработке обращения.

Сканируйте QR-код или нажмите на него для перехода по ссылке.

При выборе Telegram, WhatsApp учитывайте, что Яндекс не контролирует, как сторонние мессенджеры хранят ваши данные и переписку на своей стороне, и не несет за это ответственность.

Написать в Viber

Для обращений из Республики Беларусь

Написать в чат

Позвонить

Клиентам и представителям агентств можно связаться с нами круглосуточно по телефонам:

Регионы России: 8 800 700-47-45 (звонок из России бесплатный)

Москва: +7 495 139-91-93

Беларусь: +375 17 336-31-36

Узбекистан: +998 71 205-58-05

Казахстан: +7 727 344-31-31

Для доступа к кампаниям специалисту потребуется PIN-код

Написать письмо


 
Предыдущая
Передача ссылки на предложение
Следующая
Передача предложений Яндексу