Retrieve an invoice
Returns a single invoice by id, in the same shape as each row of the list endpoint. The invoice must belong to the environment the API key belongs to, otherwise the response is a 404.
Autorizaciones
API key sent as a bearer token in the Authorization header.
Parámetros de ruta
Opaque invoice identifier — the id from a list row.
Respuesta
The requested invoice.
A tax invoice as exposed by the public API.
Opaque, prefixed invoice identifier.
"inv_clx123abc456"
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.
"issued"
Human-readable invoice number.
"2026-000123"
Lowercase ISO 4217 currency code.
"eur"
Net total before tax, in minor units (cents) of the currency.
8300
Total tax, in minor units (cents) of the currency.
1743
Gross total including tax, in minor units (cents) of the currency. Always equals subtotal + tax.
10043
Fiscal name of the invoice recipient (company or person), or null when none is recorded.
"ACME, S.L."
Tax identifier of the recipient (e.g. NIF/CIF), or null when none is recorded.
"B12345678"
Recipient email, or null when none is recorded.
"cliente@example.com"
Customer identifier from the originating integration, or null when unavailable.
"cus_9aZ"
Invoice issue date, RFC 3339 in UTC.
"2026-06-01T09:30:00Z"
Date the underlying operation took place, RFC 3339 in UTC. Often equal to invoice_date.
"2026-06-01T09:30:00Z"
Creation timestamp, RFC 3339 in UTC.
"2026-06-01T09:30:00Z"
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.
"complete"
Identifier of the number series the invoice was issued on. See the Number Series resource.
"ns_clx456def789"
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.
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.
"https://api.finseed.es/v1/invoices/inv_clx123abc456/file?token=..."
Verifactu artifacts and AEAT registration state. Null only for legacy invoices imported before Verifactu tracking existed.
The lines that make up the invoice.
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.
"original"
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 } }).
- Option 1
- Option 2
The rectifying invoices that correct this invoice, one { invoice_id } entry each. Empty when nothing rectifies it. Voided rectificativas are excluded.