Private API Reference

Loan Applications

A Loan Application is a request for credit submitted by a customer. Once submitted, Increase reviews the application and either approves it, yielding a Loan Offer, or rejects it.

Events

Your application can listen to webhooks about this resource. The events about Loan Applications will have the categories "loan_application.created" or "loan_application.updated" .

The Loan Application object

{
  "approval": null,
  "created_at": "2020-01-31T23:59:59Z",
  "entity_id": "entity_n8y8tnk2p9339ti393yi",
  "id": "loan_application_mpe6oe4a2gc5knzl1xfy",
  "idempotency_key": null,
  "parameters": [
    {
      "amount": null,
      "category": "string",
      "enumerated_option": null,
      "key": "event_name",
      "text": {
        "value": "Cherry Street Pier Market"
      }
    }
  ],
  "program_id": "program_i2v2os4mwza1oetokh9i",
  "rejection": null,
  "status": "pending_reviewing",
  "type": "loan_application"
}

Attributes

approval

dictionary

Nullable

If the Loan Application has been approved, this contains details of the approval.

created_at

string

The ISO 8601 date and time at which the Loan Application was created.

entity_id

string

The identifier of the Entity applying for credit.

More about Entities.

string

The Loan Application’s identifier.

idempotency_key

string

Nullable

The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

parameters

array

The values the applicant provided for the Program’s application parameters.

program_id

string

The identifier of the Program under which the application was submitted.

More about Programs.

rejection

dictionary

Nullable

If the Loan Application has been rejected, this contains details of the rejection.

status

enum

The status of the Loan Application.

type

string

A constant representing the object’s type. For this resource it will always be loan_application.

List Loan Applications

curl \
  --url "${INCREASE_URL}/loan_applications" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

Returns a list response :

{
  "data": [
    { /* Loan Application object */ },
    { /* Loan Application object */ }
    /* ... */
  ],
  "next_cursor": "v57w5d",
}

Parameters

status.in

array of strings

Filter Loan Applications for those with the specified status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three.

idempotency_key

string

Filter records to the one with the specified idempotency_key you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

Between 1 and 200 characters

More parameters

cursor

string

limit

integer

Create a Loan Application

curl -X "POST" \
  --url "${INCREASE_URL}/loan_applications" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "entity_id": "entity_n8y8tnk2p9339ti393yi",
    "parameters": [
      {
        "category": "string",
        "key": "event_name",
        "text": {
          "value": "Cherry Street Pier Market"
        }
      }
    ],
    "program_id": "program_i2v2os4mwza1oetokh9i"
  }'

Parameters

entity_id

string

Required

The identifier of the Entity applying for credit.

More about Entities.

parameters

array

Required

The values for the Program’s application parameters.

program_id

string

Required

The identifier of the Program to apply under.

More about Programs.

Retrieve a Loan Application

curl \
  --url "${INCREASE_URL}/loan_applications/loan_application_mpe6oe4a2gc5knzl1xfy" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

Parameters

loan_application_id

string

Required

The identifier of the Loan Application.

More about Loan Applications.

Sandbox: Approve a Loan Application

Simulates the approval of a Loan Application by Increase, yielding a Loan Offer. This Loan Application must first have a status of pending_reviewing.

curl -X "POST" \
  --url "${INCREASE_URL}/simulations/loan_applications/loan_application_mpe6oe4a2gc5knzl1xfy/approve" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "amount": 1000000,
    "fee": 50000,
    "interest_rate": "0.07"
  }'

Parameters

loan_application_id

string

Required

The identifier of the Loan Application you wish to approve.

More about Loan Applications.

amount

integer

Required

The amount of the resulting Loan Offer in the minor unit of the currency. For dollars, this is cents.

fee

integer

Required

The origination fee of the resulting Loan Offer in the minor unit of the currency. For dollars, this is cents.

interest_rate

string

Required

The interest rate of the resulting Loan Offer, as a decimal.

Sandbox: Reject a Loan Application

Simulates the rejection of a Loan Application by Increase, generating an adverse action notice. This Loan Application must first have a status of pending_reviewing.

curl -X "POST" \
  --url "${INCREASE_URL}/simulations/loan_applications/loan_application_mpe6oe4a2gc5knzl1xfy/reject" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "reason": "credit_score"
  }'

Parameters

loan_application_id

string

Required

The identifier of the Loan Application you wish to reject.

More about Loan Applications.

reason

enum

Required

The reason the Loan Application is being rejected.