Create a Loan application

Create a Loan application

POST https://sandbox-api.stilt.com/v1/users/{user_id}/loans/applications

Returns the loan application object if successful. Returns an error if create parameters are invalid (e.g. omitting amount).

Path Parameters

Name	Type	Description
user_id*	string	The uuid of the user

Request Body

Name	Type	Description
decision	enum	The decision of the loan application. If using Onbo's decisioning engine, omit this field. Possible values: approved, rejected
reasons	String	A list of reasons for rejecting a loan application, which is required when decision is set to rejected. A reason is an enum. See Reject Reasons for a list of possible values.
amount*	float	The principal amount of the Loan application, in USD
offers	array	A list of objects, where each object represents the terms of a loan offer. An offer is structured as follows: { "apr": float, "amount": float, "term": int, "term_frequency": string, "interest_rate": float, "origination_fee": float } If using Onbo's decisioning engine, omit this.

200: OK Loan application successfully created (application approved)

{
    "uuid": "d3041dbf-831e-4836-8afc-f2ca3fdab28c",
    "product": "LOAN",
    "amount": 8000.0,
    "term": null,
    "purpose": null,
    "details": null,
    "credit_score_consent": false,
    "created_at": "2022-07-27 16:04:52 US/Pacific",
    "credit_report_id": null,
    "offers": [
        {
            "uuid": "61f965d8-af66-4bcc-a592-b6967b519d36",
            "product": "LOAN",
            "apr": 0.0,
            "amount": 8000.0,
            "term": 6,
            "term_frequency": "MONTHLY",
            "interest_rate": 0.0,
            "origination_fee": 0.0,
            "interest_only_period": null,
            "interest_only_installment": null,
            "interest_amount": null,
            "installment": null,
            "start_date": "2022-07-27",
            "explanation": null,
            "maturity_date": null
        }
    ],
    "status": {
        "decision": "APPROVED",
        "details": null
    }
}

401: Unauthorized

{
    // Response
}

403: Forbidden

{
    // Response
}

200: OK Loan application successfully created (application rejected)

{
    "uuid": "92996594-dc12-414c-b0ed-4e9cca344c1b",
    "product": "BNPL",
    "amount": 2500.0,
    "term": null,
    "purpose": null,
    "details": null,
    "credit_score_consent": false,
    "created_at": "2022-05-19 11:36:26 PDT",
    "credit_report_id": 570,
    "offers": [],
    "status": {
        "decision": "REJECTED",
        "details": [
            "Bank account balance is too low"
        ]
    }
}

400 Invalid offer for accepted application

{
    "message": "APR out-of-range for state: TX"
}

400 Invalid or missing reason for rejected appilcation

{
    "message": "Reasons must be defined when decision is REJECTED"
}