Applications

Reject an application

POST

Updates the status of a credit application to rejected and returns a user readable rejection reason, to be used in the adverse action notice

Path parameters

application_idstringRequired

Request

This endpoint expects an object.
rejection_reasons
list of enumsRequired

Response

This endpoint returns an object
status
enum
id
stringOptional
borrower_id
stringOptional

The borrower_id of the borrower the application belongs to

created_on
datetimeOptional
Timestamp the application object is created on
credit_type
enumOptional
The type of credit product.
decisioned_on
datetimeOptional
Timestamp when the application is either approved or rejected on
offers
list of unionsOptional
If the application is approved, an object containing the credit offer details
rejection_reasons
list of enumsOptional
If the application is rejected, a list containing 1-4 rejection reason(s). The Rejection Reasons endpoint provides a list of valid reasons and descriptors
requested_amount
integerOptional
If the borrower requests an amount in their application, the requested loan or credit line amount in cents (e.g. 500000 for $5,000)
third_party_disbursement_destination
stringOptional

For credit applications of type consumer_bnpl, the third party (i.e. merchant) receiving the funds is specified here

lender_of_record
stringOptional
The lender of record
credit_data
objectOptional

Errors

POST
1curl -X POST https://production.pier-finance.com/api/applications/app_f0467657bba948e6a87292e182132848/reject \
2     -H "Authorization: Bearer <token>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "rejection_reasons": [
6    "bank_balance_too_low"
7  ]
8}'
1{
2  "status": "rejected",
3  "id": "app_f0467657bba948e6a87292e182132848",
4  "borrower_id": "bor_1677bbbaf21a4954bb114bd9c4348d8a",
5  "created_on": "2022-12-31T02:20:35.934Z",
6  "credit_type": "consumer_installment_loan",
7  "decisioned_on": "2022-12-31T02:21:01.842Z",
8  "rejection_reasons": [
9    "bank_balance_too_low"
10  ],
11  "lender_of_record": "lender"
12}
Built with