Skip to main content
POST
Remove invoice lines

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

The id of the invoice to remove line items from.

Body

application/json
lines
string[]
required

ids of the line items to remove from the invoice. Must contain at least one id, and every id must belong to a line item of the invoice.

Minimum array length: 1

Response

The updated invoice, without the removed line items and with the recalculated total.

id
string
required

Unique identifier of the invoice.

Example:

"inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"

hosted_invoice_url
string | null
required

URL of the hosted invoice page, where your customer can view and pay the invoice. null for invoices that are not open. In test mode, the URL points to the test mode portal.

Example:

"https://acme.billing.fintoc.com/invoices/inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"

object
any
required

Type of the object. Always invoice.

attempt_count
integer
required

Number of automatic charge attempts Fintoc has made on the invoice. 0 until the invoice is finalized and charged for the first time.

Example:

1

collection_method
enum<string>
required

The way Fintoc collects the invoice. charge_automatically means Fintoc charges default_payment_method once the invoice is finalized. send_invoice means Fintoc leaves the invoice open for you to collect, through hosted_invoice_url or outside Fintoc. Subscription invoices inherit the collection method when issued and keep that collection method even if the subscription changes later.

Available options:
charge_automatically,
send_invoice
Example:

"send_invoice"

created_at
string<date-time>
required

ISO 8601 timestamp of when the invoice was created.

Example:

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

currency
enum<string>
required

Currency of the invoice, as an ISO 4217 code. Every line item uses this currency.

Available options:
CLP,
MXN
Example:

"CLP"

customer
string
required

id of the customer the invoice bills.

Example:

"cus_2bVdWyTnGq4PfLs7DkXjRm0CwIo"

default_payment_method
string | null
required

id of the payment method Fintoc charges when the invoice is finalized. null for invoices without one, such as subscription invoices.

Example:

"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"

external_payment
boolean
required

Whether the invoice was settled with a payment collected outside Fintoc. false for invoices Fintoc collected, and for invoices that are not yet paid.

Example:

false

lines
object[]
required

Line items that make up the invoice total.

metadata
object | null
required

Set of key-value pairs attached to the invoice. null when the invoice has no metadata.

mode
enum<string>
required

Mode of the invoice. live invoices use real data; test invoices use fake data for integration testing. An API key only sees invoices that share its mode.

Available options:
live,
test
Example:

"live"

next_payment_attempt_at
string<date-time> | null
required

ISO 8601 timestamp of the next scheduled automatic charge attempt. null when no further attempt is scheduled.

Example:

"2026-05-02T12:00:00Z"

payments
object[]
required

Payment attempts to collect the invoice.

status
enum<string>
required

Status of the invoice. Invoices start as draft, become open when finalized, and end as paid or void.

Available options:
draft,
open,
paid,
void
Example:

"draft"

subscription
string | null
required

id of the subscription that generated the invoice. null for invoices not tied to a subscription.

Example:

"sub_2bVdWzKfHr5QgMt8ElYkSn1DxJp"

total
integer
required

Total amount of the invoice, in the smallest unit of currency (for example, 30000 for $30000 CLP, since CLP has no minor unit, or 3000 for $30.00 MXN). Equals the sum of the line item amounts.

Example:

30000