Standard response codes

200 OK

Parameter

Description

Type

Required

Comment

search_id

Request ID.

string

Yes

status

Request status.

string

Yes

Reference value:

  • "pending": In progress.
  • "done": Completed.

name

Organization name.

string

Yes

decision

Application decision.

string

Yes

Reference value:

  • "has_approve": Approved.
  • "rejected": Rejected.

data

Decision array.

array

No

If there's only one offer, the array contains a single element.

product_type

Credit product name.

string

Yes

Reference value:

  • loan: Cash loan.
  • "credit_card": Credit card.

decision

Decision for the banking product.

string

Yes

Reference value:

  • "pre_approved": Pre-approved.
  • "full_approved": Fully approved.

amount

Loan amount.

object

Yes

If the product is "credit_card", this refers to the credit limit.

amount.min

Minimum loan amount.

number

Yes

amount.max

Maximum loan amount.

number

Yes

term

Loan term.

object

Yes, if product_type = "loan".

term.min

Minimum loan term.

number

Yes

Specify in months.

term.max

Maximum loan term.

number

Yes

Specify in months.

rate

Loan interest rate.

object

Yes

rate.min

Minimum interest rate.

number

Yes

rate.max

Maximum interest rate.

number

Yes

total_cost

Full loan cost.

object

Yes

total_cost.min

Minimum full loan cost.

number

Yes

total_cost.max

Maximum full loan cost.

number

Yes

grace_period

Grace period.

number

Yes, if product_type = "credit_card".

It's specified in days.

payment

Monthly payment.

object

Yes

payment.min

Minimum monthly payment.

number

Yes, if product_type = "loan".

payment.max

Maximum monthly payment.

number

Yes, if product_type = "loan".

payment.cc_rate

Minimum credit card payment.

number

Yes, if product_type = "credit_card".

Specify as a percentage: payment.cc_rate = 10 // 10% of the outstanding balance.

special_conditions

Additional terms and conditions.

array

No

Array of strings.

required_documents

Required documents.

array

No

Array of strings.

choosable_documents

Optional documents.

array

No

Array of strings. Example: "choosable_documents": ["2-NDFL certificate, Proof of employment","Confirmation on Gosuslugi"].

propousal_link

Link to the offer.

object

Yes

The object must include at least one link to the application form.

propousal_link.link

Link to website.

string

No

propousal_link.deep

Link to the app.

string

No

props

Additional service parameters.

array

No

An array of strings that can contain any service information specified outside this page.

For asynchronous data processing:

Parameter

Description

Type

Required

Comment

search_id

Request ID.

string

Yes

Parameter for repeat requests.

404 Not Found

Parameter

Description

Type

Required

Comment

search_id

Request ID.

string

Yes

Parameter for repeat requests.

message

Error message.

string

Yes

400 Bad Request

Parameter

Description

Type

Required

Comment

search_id

Request ID.

string

Yes

Parameter for repeat requests.

message

Error message.

string

Yes

properties

Field array with error details.

array

No

403 Access Forbidden

Parameter

Description

Type

Required

Comment

search_id

Request ID.

string

Yes

Parameter for repeat requests.

message

Error message.

string

Yes

500 Internal Server Error

Parameter

Description

Type

Required

Comment

search_id

Request ID.

string

Yes

Parameter for repeat requests.

message

Error message.

string

Yes

API reference

Offer examples

Have questions?

Alert

Our customer service department can only help you with the campaigns created under the same username you use to contact us. You can check your username by opening ya.ru in another browser tab. Our team can access your data only when processing your request.

Scan the QR code or tap it to follow the link.

Message us on WhatsApp
Message us on Telegram
Call

You can contact us from 10:00 to 19:00 (UTC+3) by phone:

Moscow: +7 495 139-91-93

Russia: 8 (800) 700-47-45 (toll-free within Russia)

To access campaigns, the customer service specialist will need your PIN.

Leave a message