LendingPayments

Apply collateral

Apply locked collateral to the principal balance of a secured loan.

post/loans/{loan_id}/apply_collateral

Request

  • Base URL: https://api.column.com
  • URL: https://api.column.com/loans/{loan_id}/apply_collateral
  • Auth: HTTP basic

Path parameters

loan_idstring required

Headers

Idempotency-Keystring

Idempotency keys can be up to 255 characters long and are case sensitive. Column reserves the right to expire idempotency keys after 30 days. Only ASCII printable characters (code 32 - 126) are allowed for idempotency keys.

Request body

amountinteger required

Amount of locked collateral to apply to loan principal, in cents.

currency_codestring required

Currency of the collateral application. Must match the loan currency.

descriptionstring

Description of the collateral application. Maximum: 127 characters.

Response

Successful response

account_number_idstring required

The unique ID of the account to which the payment was made

amountinteger required

Total payment amount in cents

bank_account_idstring required

The bank account to which funds are paid back to

collection_account_number_idstring required

ID of your collections account number

collection_bank_account_idstring required

ID of your collections account

created_atstring date-time required

The timestamp the loan payment was created

currencystring required

The currency of the loan. Currently only USD is supported.

descriptionstring required

The description of the loan payment in the Column dashboard

effective_atstring date-time required

The timestamp the loan payment was marked effective

idstring required

The ID of the loan payment object

idempotency_keystring required

The idempotency key specified in the loan payment. Returns an empty string "" when not set.

ignore_retained_balancesboolean required

Indicates whether the loan payment was applied to sold balances only. Read more.

interest_amountinteger required

Total paid interest receivable

is_offlineboolean required

Indicates whether the loan payment was made offline

loan_idstring required

The ID of the loan object the loan payment is associated to

principal_amountinteger required

Amount of the payment applied to the loan principal

retained_interest_amountinteger required

Paid interest receivable owned by Column

retained_principal_amountinteger required

Paid principal amount owned by Column

statusstring required

The current status of the loan payment. Possible values: completed, or returned.

Example response

{
  "account_number_id": "acno_2zI1Da9Ro0dvk6HT2gla1H0UTyS",
  "amount": 1000,
  "bank_account_id": "bacc_2zI1DavEbJQbbOIJeExDVJczhqM",
  "collection_account_number_id": "",
  "collection_bank_account_id": "",
  "created_at": "2025-08-03T16:05:12Z",
  "currency": "USD",
  "description": "first payment",
  "effective_at": "2025-08-03T16:05:12Z",
  "id": "lpmt_30mdxZgaXqKELJ5xRVKKj2x3Vrz",
  "idempotency_key": "",
  "ignore_retained_balances": false,
  "interest_amount": 200,
  "is_offline": false,
  "loan_id": "loan_30mcttnSZBlSahXy6LUFzbeemlk",
  "principal_amount": 800,
  "retained_interest_amount": 0,
  "retained_principal_amount": 0,
  "status": "completed"
}

Changes

No recorded changes to this operation across all 1 revision of this API.