Create a LOC application

Create a LOC application

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

Returns the loc 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 LOC application. If using Onbo's decisioning engine, omit this field. Possible values: approved, rejected
reasons	String	A list of reasons for rejecting a LOC 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 LOC application, in USD
offers	array	A list of objects, where each object represents the terms of a LOC 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 LOC application successfully created (application approved)

{
    "uuid": "05e7e541-95b0-4294-8374-9f341f1ae857",
    "product": "BUILD_CREDIT",
    "amount": 2500.0,
    "term": null,
    "purpose": null,
    "details": null,
    "credit_score_consent": false,
    "created_at": "2022-05-19 11:28:45 PDT",
    "credit_report_id": 570,
    "offers": [
        {
            "uuid": "b94bc34a-add6-4756-839e-322e357ef307",
            "product": "BUILD_CREDIT",
            "apr": 0.0,
            "amount": 2500.0,
            "term": null,
            "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-05-19",
            "explanation": null,
            "maturity_date": null
        }
    ],
    "status": {
        "decision": "APPROVED",
        "details": null
    }
}

401: Unauthorized

{
    // Response
}

403: Forbidden

{
    // Response
}

200: OK LOC application successfully created (application rejected)

{
    "uuid": "92996594-dc12-414c-b0ed-4e9cca344c1b",
    "product": "BUILD_CREDIT",
    "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 Offer terms do not meet state limitations

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

400 Missing or invalid reason for rejected application

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