Get an application by ID — Pier

Get an application by its id

Path parameters

application_idstringRequired

Response

This endpoint returns an object.

statusenum

idstringOptional

borrower_idstringOptional

The borrower_id of the borrower the application belongs to

created_ondatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Timestamp the application object is created on

credit_typeenumOptional

The type of credit product.

decisioned_ondatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Timestamp when the application is either approved or rejected on

offerslist of objectsOptional

If the application is approved, an object containing the credit offer details

rejection_reasonslist 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_amountintegerOptional

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_destinationstringOptional

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

lender_of_recordstringOptional

The lender of record

credit_dataobjectOptional

Errors

1 curl https://production.pier-finance.com/api/applications/app_f0467657bba948e6a87292e182132848 \ 2 -H "Authorization: Bearer <token>"

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 "first_payment_date": "2022-12-31", 18 "grace_period": { 19 "term": 21, 20 "interest_rate": 0 21 }, 22 "interest_rate": 0, 23 "introductory_promo_period": { 24 "interest_rate": 0, 25 "promo_term": { 26 "term": 90, 27 "term_type": "daily" 28 } 29 }, 30 "late_payment_fee": 0, 31 "minimum_payment": { 32 "type": "interest_plus_percentage_of_principal", 33 "value": 500, 34 "floor": 3000 35 }, 36 "origination_fee": 0, 37 "payment_period": "monthly" 38 } 39 ], 40 "rejection_reasons": [], 41 "lender_of_record": "lender" 42 }

1	curl https://production.pier-finance.com/api/applications/app_f0467657bba948e6a87292e182132848 \
2	-H "Authorization: Bearer <token>"

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	"first_payment_date": "2022-12-31",
18	"grace_period": {
19	"term": 21,
20	"interest_rate": 0
21	},
22	"interest_rate": 0,
23	"introductory_promo_period": {
24	"interest_rate": 0,
25	"promo_term": {
26	"term": 90,
27	"term_type": "daily"
28	}
29	},
30	"late_payment_fee": 0,
31	"minimum_payment": {
32	"type": "interest_plus_percentage_of_principal",
33	"value": 500,
34	"floor": 3000
35	},
36	"origination_fee": 0,
37	"payment_period": "monthly"
38	}
39	],
40	"rejection_reasons": [],
41	"lender_of_record": "lender"
42	}