Applications

Approve an application

POST

Path parameters

application_idstringRequired

Request

This endpoint expects an object.
offers
list of unionsRequired

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/approve \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "offers": [
6 {
7 "type": "revolving_line_of_credit_offer",
8 "amount": 1000000,
9 "annual_fee": 0,
10 "apr": 0,
11 "billing_cycle": 30,
12 "finance_charge": 0,
13 "grace_period": {
14 "term": 21,
15 "interest_rate": 0
16 },
17 "interest_rate": 0,
18 "late_payment_fee": 0,
19 "minimum_payment": {
20 "type": "interest_plus_percentage_of_principal",
21 "value": 500,
22 "floor": 3000
23 },
24 "origination_fee": 0
25 }
26 ]
27}'
1{
2 "status": "approved",
3 "id": "app_f0467657bba948e6a87292e182132848",
4 "borrower_id": "bor_d965bea9f47a4b108562642dbb1dae9f",
5 "created_on": "2022-12-31T01:36:52.606Z",
6 "credit_type": "consumer_revolving_line_of_credit",
7 "decisioned_on": "2023-01-17T05:31:52.955Z",
8 "offers": [
9 {
10 "type": "revolving_line_of_credit_offer",
11 "amount": 1000000,
12 "id": "off_86c05092a4384d89b03ef514ea4fee31",
13 "annual_fee": 0,
14 "apr": 0,
15 "billing_cycle": 30,
16 "finance_charge": 0,
17 "grace_period": {
18 "term": 21,
19 "interest_rate": 0
20 },
21 "interest_rate": 0,
22 "late_payment_fee": 0,
23 "minimum_payment": {
24 "type": "interest_plus_percentage_of_principal",
25 "value": 500,
26 "floor": 3000
27 },
28 "origination_fee": 0
29 }
30 ],
31 "rejection_reasons": [],
32 "lender_of_record": "lender"
33}