Saltar al contenido principal
GET
/
v1
/
invoices
/
{id}
Retrieve an invoice
curl --request GET \
  --url https://api.easyverifactu.com/v1/invoices/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "inv_clx123abc456",
  "status": "issued",
  "number": "2026-000123",
  "currency": "eur",
  "subtotal": 8300,
  "tax": 1743,
  "total": 10043,
  "recipient_name": "ACME, S.L.",
  "recipient_tax_id": "B12345678",
  "email": "cliente@example.com",
  "external_customer_id": "cus_9aZ",
  "invoice_date": "2026-06-01T09:30:00Z",
  "operation_date": "2026-06-01T09:30:00Z",
  "created_at": "2026-06-01T09:30:00Z",
  "line_items": [
    {
      "id": "ili_clx789def012",
      "description": "Consulting services",
      "sku": "SVC-01",
      "quantity": 2,
      "unit_amount": 4150,
      "subtotal": 8300,
      "tax": 1743,
      "total": 10043,
      "tax_items": [
        {
          "name": "IVA 21%",
          "type": "vat",
          "rate": 21,
          "amount": 1743
        }
      ]
    }
  ]
}

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"

​
line_items
object[]
requerido

The lines that make up the invoice.