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": "loan_offer",
8      "amount": 1000000,
9      "id": "off_86c05092a4384d89b03ef514ea4fee31",
10      "loan_term": {
11        "term_type": "months",
12        "term": 36
13      },
14      "first_payment_date": "2022-12-31",
15      "grace_period": {
16        "term": 0,
17        "interest_rate": 0
18      },
19      "interest_rate": 0,
20      "late_payment_fee": 0,
21      "origination_fee": 0,
22      "payment_period": "monthly"
23    }
24  ]
25}'
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}
Built with