Sign in

v1

latestOpenAPI 3.1.02026-07-247328324.6 KB
Receivables

Update an item

patch/creditors/{creditor_id}/receivables/{receivable_id}/items/{id}

Path parameters

creditor_idstring required

An object id with prefix

Example:user_0123456789ABCDEFGHIJKLMNOPq

An object id with prefix

receivable_idstring required

An object id with prefix

Example:user_0123456789ABCDEFGHIJKLMNOPq

An object id with prefix

idstring required

An object id with prefix

Example:user_0123456789ABCDEFGHIJKLMNOPq

An object id with prefix

Headers

if-matchstring date-time required

ETag value for Optimistic Concurrency Control (OCC). Should contain the last known updated_at timestamp in ISO 8601 format.

Example:2024-01-15T10:30:00Z

ETag value for Optimistic Concurrency Control (OCC). Should contain the last known updated_at timestamp in ISO 8601 format.

Request body

datestring date

Date on which the transaction occurred

amountinteger

Amount for the transaction

balanceinteger

Receivable balance including the amount in this transaction

type'disbursement' | 'interest' | 'late_fee' | 'origination_fee' | 'periodic_fee' | 'principal' | 'refund' | 'other'

Type of the transaction being reported

receivable_status'active' | 'closed'

Status of the receivable at the time the transaction occurred

descriptionstring nullable

Description associated with this transaction

metadataobject nullable

Additional custom data associated with this receivable item

Example request

{
  "date": "2024-01-15",
  "amount": 10000,
  "balance": 10000,
  "metadata": {
    "key": "value"
  }
}

Response

Successful operation

datestring date required

Date on which the transaction occurred

amountinteger required

Amount for the transaction

balanceinteger required

Receivable balance including the amount in this transaction

type'disbursement' | 'interest' | 'late_fee' | 'origination_fee' | 'periodic_fee' | 'principal' | 'refund' | 'other' required

Type of the transaction being reported

receivable_status'active' | 'closed' required

Status of the receivable at the time the transaction occurred

descriptionstring

Description associated with this transaction

metadataobject

Additional custom data associated with this receivable item

idstring required

An object id with prefix

created_atstring date-time required

Creation date and time

created_bystring required

ID of the user that created this object

updated_atstring date-time required

Last update date and time

updated_bystring required

ID of the user that last updated this object

Example response

{
  "date": "2024-01-15",
  "amount": 10000,
  "balance": 10000,
  "metadata": {
    "key": "value"
  },
  "id": "user_0123456789ABCDEFGHIJKLMNOPq",
  "created_at": "2024-01-15T10:30:00Z",
  "created_by": "user_0123456789ABCDEFGHIJKLMNOPq",
  "updated_at": "2024-01-15T10:30:00Z",
  "updated_by": "user_0123456789ABCDEFGHIJKLMNOPq"
}