Verifactu API for your invoicing software
The Verifacti Verifactu API connects your invoicing software with the Spanish Tax Agency (AEAT): you send each invoice as JSON, get the QR code instantly, and Verifacti generates the invoicing record, chains it and submits it to the AEAT on the taxpayer’s behalf, without you needing a digital certificate. You can try it with a free account, which includes a test environment and a test NIF.
Test environment and test NIF included{
"serie": "A",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"tipo_factura": "F1",
"nif": "A15022510",
"importe_total": "242",
…
}{
"estado": "Pendiente",
"qr": "iVBORw0KGgoAAAANSUhEUgAA…",
"huella": "B11F3A01…"
}How the Verifactu API works
- 1
You send the invoice as JSON
Your software calls the API with the invoice data and the issuing NIF’s API key.
- 2
You get the QR instantly
The response includes the QR in Base64, ready to print on the invoice.
- 3
Verifacti submits the record to the AEAT
We generate the invoicing record, compute its fingerprint (hash), chain it to the previous one and submit it to the AEAT in the background.
Submission to the AEAT does not block issuing the invoice: the result reaches you by webhook or by checking the record’s status.
Example: create an invoice with the Verifactu API
A full invoice (F1) against the test environment. Copy the request, add your test API key and it works.
curl -X POST https://api.verifacti.com/verifactu/create \
-H "Authorization: Bearer $VERIFACTI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"serie": "A",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"tipo_factura": "F1",
"descripcion": "Factura normal",
"nif": "A15022510",
"nombre": "Nombre cliente",
"lineas": [{
"base_imponible": "200",
"tipo_impositivo": "21",
"cuota_repercutida": "42"
}],
"importe_total": "242"
}'{
"uuid": "b018ced3-b362-4494-8776-9eefff1c160c",
"estado": "Pendiente",
"url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=…",
"qr": "iVBORw0KGgoAAAANSUhEUgAA…",
"huella": "B11F3A015173AD99075E2720F61E2DE1…"
}What the Verifactu API includes
Validation before sending
Every invoice is validated before it is sent to the AEAT, including the recipient’s NIF against the AEAT and VIES, and any error comes back with a code (code catalogue).
QR instantly
In the response, in Base64, to print next to the VERI*FACTU legend. QR size and position.
Retries without duplicates
With the
Idempotency-Keyheader, repeating the same request returns the original response for 24 hours.AEAT responses by webhook
Or by checking the record’s status whenever you want.
Corrective invoices, cancellation and amendments
Corrective invoices (R1–R5) and credit notes with the same create endpoint; cancellation and modification with their own. Corrective invoice examples.
No digital certificate
Verifacti is an AEAT social collaborator. Each taxpayer signs the representation form once, also online, without a certificate.
VERI*FACTU mode only
Every record is sent to the AEAT in real time; the API does not cover the NO VERI*FACTU mode. Verifactu modes.
Your data, in the EU and exportable
Data is hosted in the European Union and you can export your records at any time. The SLA is in the terms of use.
One integration per regulation, on top of the NIF management API
You integrate the NIF management API once: registering, activating and removing NIFs, representation and webhooks. Each regulation then adds its own submission integration, close to the target administration’s API. If a NIF is taxed in Álava, Bizkaia or Gipuzkoa, it uses the TicketBAI API with the same NIF management.
Why Verifacti for Verifactu
Built for developers
Public documentation with examples for every call, quick start guide, Postman collections, llms.txt and a free account with a test environment.
Typical integration: one to three developer daysSpecialists in Spain
Common and foral territory: Verifactu, TicketBAI and SII with one provider.
TicketBAI guarantor software in Álava, Bizkaia and GipuzkoaProven reliability
Hundreds of companies and software vendors already send their invoices with Verifacti.
AEAT social collaboratorVerifactu: dates and who it applies to
Verifactu is the AEAT system that requires invoicing software to generate tamper-proof records and, in VERI*FACTU mode, send them in real time (RD 1007/2023). It applies in common territory; businesses in the SII or taxed in foral territory are excluded.
| Who | Date | Status | Rule |
|---|---|---|---|
| Producers and resellers of invoicing software RDL 15/2025 did not change this date. | Since 29 Jul 2025 | In force | RD 1007/2023 · Orden HAC/1177/2024 |
| Corporate Income Tax payers | 1 Jan 2027 | Published in the BOE, future date | RDL 15/2025 |
| Everyone else, including the self-employed | 1 Jul 2027 | Published in the BOE, future date | RDL 15/2025 |
| Postponement of the pending obligations The note does not specify the scope for businesses invoicing over €8M. | Oct 2028 | Announced, no rule published | Nota de Hacienda, 5 oct 2026 |
This is not advice: each taxpayer determines what applies to them with their adviser.
- The price per NIF goes down with every tier.
- Up to 3,000 invoicing records per month per NIF.
- Online signing of the representation form: €2.90 + VAT.
- Free test environment and test NIF.
- Annual plan with a 10% discount, no setup fees.
- Same price with the TicketBAI API.
- Startup plan for companies under 12 months old, with under €100,000 in revenue and under €200,000 in funding.
What those who already integrated it say

«La integración con Verifactu fue muy sencilla y el soporte ha sido excelente. Siempre atentos y rápidos para resolver dudas. Muy contento con el servicio.»
«Hemos integrado nuestro software en tiempo récord. La documentación es clara y sencilla, y los ejemplos variados y muy útiles. El equipo de soporte me ha ayudado con todas las dudas.»
“Verifacti’s SaaS platform is intuitive and reliable, and their team’s deep expertise and prompt, crystal-clear answers helped us reach our goals on time. They’re not only highly knowledgeable and professional but also a genuine pleasure to work with.”
“Verifacti made Veri*factu compliance surprisingly straightforward. Their API is clean, well-documented, and their support team responds with real solutions — not generic replies. For any SaaS serving Spanish businesses, Verifacti is the partner you want.”Everything you need to integrate
Questions about the Verifactu API
More questions about the Verifactu APIDo I need a digital certificate to send invoices to Verifactu with the API?
Is there a test environment for Verifactu?
vf_test_ API keys, which submit to the AEAT test environment, and a test NIF. The API URLs are the same in test and production.Has Verifactu been postponed? Do I need to integrate now?
Can you help me with the statement of conformity?
GET /verifactu/declaracion. More in statement of conformity.How long does it take to integrate the Verifactu API?
I already integrated Verifactu. Will it work for B2B e-invoicing?
Keep reading
Start integrating today
Try it for free with the test environment.