Skip to main content
PATCH
Update an invoice line item
v2 · Base URL https://api.fintoc.com/v2

Authorizations

Authorization
string
header
required

Path Parameters

invoice_id
string
required

The id of the invoice the line item belongs to.

id
string
required

The id of the line item to update.

Body

application/json
amount
integer

New amount of the line item, in the smallest unit of currency (for example, 30000 for $30000 CLP, since CLP has no minor unit, or 3000 for $30.00 MXN). Must be greater than 0.

Example:

80000

currency
enum<string>

New currency of the line item, as an ISO 4217 code. Must match the invoice currency.

Available options:
CLP,
MXN
Example:

"CLP"

period_end
string<date-time>

New ISO 8601 timestamp marking the end of the billing period covered by the line item. Must remain after period_start.

Example:

"2026-06-01T00:00:00Z"

period_start
string<date-time>

New ISO 8601 timestamp marking the start of the billing period covered by the line item.

Example:

"2026-05-01T00:00:00Z"

quantity
integer

New number of units billed by the line item. Must be greater than 0.

Example:

2

name
string

New display name for the line item shown on the invoice.

Example:

"Premium Plan"

description
string

New additional details about the line item shown on the invoice.

Example:

"A premium plan"

Response

The updated line item. The invoice total already reflects the new amount.

id
string
required

Unique identifier of the line item.

Example:

"il_2bVdX0PqJs6RhNu9FmZlTo2EyKq"

object
any
required

Type of the object. Always line_item.

amount
integer
required

Amount of the line item, in the smallest unit of currency (for example, 30000 for $30000 CLP, since CLP has no minor unit, or 3000 for $30.00 MXN).

Example:

30000

currency
enum<string>
required

Currency of the line item, as an ISO 4217 code. Always matches the invoice currency.

Available options:
CLP,
MXN
Example:

"CLP"

description
string | null
required

Additional details about the line item shown on the invoice. null when the line item has no description.

Example:

"A premium plan"

name
string
required

Display name for the line item shown on the invoice.

Example:

"Premium Plan"

period_end
string<date-time> | null
required

ISO 8601 datetime in UTC marking the end of the billing period covered by the line item. null for line items on invoices not tied to a subscription.

Example:

"2026-06-01T00:00:00Z"

period_start
string<date-time> | null
required

ISO 8601 datetime in UTC marking the start of the billing period covered by the line item. null for line items on invoices not tied to a subscription.

Example:

"2026-05-01T00:00:00Z"

quantity
integer
required

Number of units billed by the line item.

Example:

1