Skip to main content
GET
Retrieve an invoice

Autorizaciones

Authorization
string
header
requerido

API key sent as a bearer token in the Authorization header.

Parámetros de ruta

id
string
requerido

Opaque invoice identifier — the id from a list row.

Respuesta

The requested invoice.

A tax invoice as exposed by the public API.

id
string
requerido

Opaque, prefixed invoice identifier.

Ejemplo:

"inv_clx123abc456"

status
string
requerido

Lifecycle status of the invoice. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: issued, voided.

Ejemplo:

"issued"

number
string
requerido

Human-readable invoice number.

Ejemplo:

"2026-000123"

currency
string
requerido

Lowercase ISO 4217 currency code.

Ejemplo:

"eur"

subtotal
integer
requerido

Net total before tax, in minor units (cents) of the currency.

Ejemplo:

8300

tax
integer
requerido

Total tax, in minor units (cents) of the currency.

Ejemplo:

1743

total
integer
requerido

Gross total including tax, in minor units (cents) of the currency. Always equals subtotal + tax.

Ejemplo:

10043

recipient_name
string | null
requerido

Fiscal name of the invoice recipient (company or person), or null when none is recorded.

Ejemplo:

"ACME, S.L."

recipient_tax_id
string | null
requerido

Tax identifier of the recipient (e.g. NIF/CIF), or null when none is recorded.

Ejemplo:

"B12345678"

email
string | null
requerido

Recipient email, or null when none is recorded.

Ejemplo:

"cliente@example.com"

external_customer_id
string | null
requerido

Customer identifier from the originating integration, or null when unavailable.

Ejemplo:

"cus_9aZ"

invoice_date
string
requerido

Invoice issue date, RFC 3339 in UTC.

Ejemplo:

"2026-06-01T09:30:00Z"

operation_date
string
requerido

Date the underlying operation took place, RFC 3339 in UTC. Often equal to invoice_date.

Ejemplo:

"2026-06-01T09:30:00Z"

created_at
string
requerido

Creation timestamp, RFC 3339 in UTC.

Ejemplo:

"2026-06-01T09:30:00Z"

type
string
requerido

Whether this is a complete invoice (identified recipient) or a simplified invoice (ticket). This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: complete, simplified.

Ejemplo:

"complete"

number_series_id
string
requerido

Identifier of the number series the invoice was issued on. See the Number Series resource.

Ejemplo:

"ns_clx456def789"

recipient
object | null
requerido

Full recipient block as recorded on the document, or null when no recipient data exists (simplified invoices). The flat recipient_name/recipient_tax_id/email fields remain as convenience aliases.

pdf_url
string
requerido

Signed link to the invoice PDF, valid for at least 24 hours from the moment this response was produced. Fetch a fresh one anytime by re-reading the invoice, or use the download endpoint. The PDF is generated shortly after creation; downloading earlier just takes a moment longer.

Ejemplo:

"https://api.finseed.es/v1/invoices/inv_clx123abc456/file?token=..."

verifactu
object | null
requerido

Verifactu artifacts and AEAT registration state. Null only for legacy invoices imported before Verifactu tracking existed.

line_items
object[]
requerido

The lines that make up the invoice.

kind
string
requerido

Whether this is an original invoice or a rectifying (corrective) one, and by which method. rectifying_differences corrects by the delta; rectifying_substitution replaces the original in full. This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: original, rectifying_differences, rectifying_substitution.

Ejemplo:

"original"

rectifies
object[]
requerido

The invoices this invoice rectifies. Empty for originals. A rectificativa issued against invoices in Finseed carries one { invoice_id } entry per corrected invoice; one issued against an external original carries a single { external: { number, issued_on } } entry.

An invoice a rectificativa corrects: either a local invoice ({ invoice_id }) or an external original ({ external: { number, issued_on } }).

rectified_by
object[]
requerido

The rectifying invoices that correct this invoice, one { invoice_id } entry each. Empty when nothing rectifies it. Voided rectificativas are excluded.