Skip to main content
POST
/
applications
/
{application_id}
/
reject
Reject an application
curl --request POST \
  --url https://production.pier-finance.com/api/applications/{application_id}/reject \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rejection_reason": "bank_balance_too_low"
}'
{
  "rejection_reasons": [
    "bank_balance_too_low"
  ],
  "id": "app_f0467657bba948e6a87292e182132848",
  "borrower_id": "bor_1677bbbaf21a4954bb114bd9c4348d8a",
  "credit_type": "installment_loan",
  "status": "rejected",
  "created_on": "2022-12-31T02:20:35.934Z",
  "decisioned_on": "2022-12-31T02:21:01.842Z"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
application_id
string
required

Body

application/json
​
rejection_reason
enum<string>
required
Available options:
income_too_low,
bank_balance_too_low,
income_unpredictable,
user_account_duplicate,
sdb_check_failed,
bank_account_linking_error,
mla_failed,
iddoc_failed,
no_checking_or_savings_data,
insufficient_bank_history,
loan_location_no_license,
address_invalid,
income_verification_failed,
stacking_behavior,
ssn_verification_failed,
too_many_nsfs,
fraud_risk_too_high,
bankruptcy,
processor_suspended,
cash_flow_verification_failed

Response

​
status
enum<string>
required
Available options:
pending,
approved,
accepted,
rejected,
expired
​
id
string
​
borrower_id
string

The borrower_id of the borrower the application belongs to

​
created_on
string<date-time>

Timestamp the application object is created on

​
credit_type
enum<string>

The type of credit product.

Available options:
installment_loan,
revolving_line_of_credit,
closed_line_of_credit
​
decisioned_on
string<date-time>

Timestamp when the application is either approved or rejected on

​
offer
object

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

  • Option 1
  • Option 2
​
rejection_reasons
enum<string>[]

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
integer

If the borrower requests an amount in their application, the requested loan or credit line amount in cents (e.g. 500000 for $5,000)