Applications

Applications represent the credit application for a borrower. Applications must be created for a given borrower, and one borrower can have many applications. Once an application is created, it must either be approved or rejected.

Applications can have a status of pending, approved, accepted, rejected, expired

Create an application

POST /applications

Approve an application

POST /applications/{application_id}/approve

Reject an application

POST /applications/{application_id}/reject

Retrieve an application by id

GET /applications/{application_id}

List all applications

GET /applications

Application object

Attributes

id

string

Unique identifier for the object

borrower_id

string

The borrower_id of the borrower the application belongs to

created_on

string

Timestamp the application object is created on

credit_type

enum

The type of credit product. Accepted values: installment_loan, revolving_line_of_credit, or closed_line_of_credit

decisioned_on

string

Timestamp when the application is either approved or rejected on

offer

object

If the application is approved, an object containing the credit offer details. See LineOfCreditOffer and LoadOffer types

rejection_reasons

list

If the application is rejected, a list containing 1-4 rejection reason(s). The Rejection Reasons 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)

status

enum

The status of the credit application. Accepted values:

pending the application is pending a decision
approved the application is approved with an offer
accepted the application offer has been accepted by the borrower
rejected the application is rejected
expired the application has expired

Application object

Example Application object

{
  "id": "app_f0467657bba948e6a87292e182132848",
  "borrower_id": "bor_a381b26f0a79480abae786796c54b8b8",
  "credit_type": "installment_loan",
  "status": "pending",
  "created_on": "2022-12-31T01:36:52.606Z",
  "rejection_reasons": []
}