GET /verifactu/invoices/{uuid}/state
GET
/verifactu/invoices/{uuid}/statePath parameters
uuidstringrequiredResponses
200Invoice state of record successfully retrieved
correlationIdstringCorrelation ID for tracking the request
csvstringCSV devuelto por AEAT para el registro
idPeticionobject | nullIdPeticion devuelto por AEAT
issue_datestringrequiredIssue date of the invoice (ISO format)
nifstringrequiredTaxpayer NIF (Número de Identificación Fiscal)
nifPresentadorobject | nullNIFPresentador devuelto por AEAT
numberstringrequiredInvoice number
operationstringrequiredType of operation performed on the invoice
Allowed:
SUBMISSIONCORRECTIONCANCELLATIONpdfUrlstring<uri>Signed URL to download the generated invoice PDF from S3
qrstringrequiredBase64-encoded QR code image (data:image/png;base64,...)
seriesstringrequiredInvoice series identifier
statestringrequiredCurrent state of the invoice in VeriFactu (e.g., Aceptada, Rechazada)
timestampPresentacionobject | nullTimestampPresentacion devuelto por AEAT
urlstring<uri>requiredFull verification URL provided by AEAT
400Bad request
correlationIdstringrequiredmessagestringrequiredpathstringrequiredstatusCodenumberrequiredsuccessbooleanrequiredtimestampstringrequired404Invoice not found
correlationIdstringrequiredmessagestringrequiredpathstringrequiredstatusCodenumberrequiredsuccessbooleanrequiredtimestampstringrequired500Internal server error
correlationIdstringrequiredmessagestringrequiredpathstringrequiredstatusCodenumberrequiredsuccessbooleanrequiredtimestampstringrequiredRequest
curl -X GET "https://api.multifactu.com/verifactu/invoices/string/state"const response = await fetch("https://api.multifactu.com/verifactu/invoices/string/state", {
method: "GET"
});import requests
response = requests.get(
"https://api.multifactu.com/verifactu/invoices/string/state",
)Response
{
"correlationId": "123e4567-e89b-12d3-a456-426614174000",
"csv": "CSV1234567890",
"idPeticion": "1234567890ABCDEF",
"issue_date": "2024-12-13T18:30:00.000Z",
"nif": "A39200050",
"nifPresentador": "B12345678",
"number": "346349001",
"operation": "CANCELLATION",
"pdfUrl": "https://bucket.s3.amazonaws.com/...&X-Amz-Signature=...",
"qr": "data:image/png;base64,iVBORw0KGgo...",
"series": "A",
"state": "Aceptada",
"timestampPresentacion": "2025-01-01T12:34:56",
"url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?..."
}{
"correlationId": "xyz",
"message": "series is required when number is provided",
"path": "/v1/verifactu/invoices/search",
"statusCode": 400,
"success": false,
"timestamp": "2025-12-21T12:10:46.668Z"
}{
"correlationId": "xyz",
"message": "Invoice not found",
"path": "/v1/verifactu/invoices/search",
"statusCode": 404,
"success": false,
"timestamp": "2025-12-21T12:10:46.668Z"
}{
"correlationId": "xyz",
"message": "Internal server error",
"path": "/v1/verifactu/invoices",
"statusCode": 500,
"success": false,
"timestamp": "2025-12-21T12:10:46.668Z"
}