Skip to main content
POST
Remove invoice lines
v2 · Base URL https://api.fintoc.com/v2

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 test mode invoices and for invoices that are not open.

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

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"

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