Saltar al contenido principal
GET
/
verifactu
/
invoices
cURL
curl --request GET \
  --url https://api.multifactu.com/verifactu/invoices \
  --header 'Authorization: Bearer <token>'
{
  "correlationId": "123e4567-e89b-12d3-a456-426614174000",
  "data": [
    {
      "num_serie": "INV2024-0001",
      "qrBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAaQAAAGkCAYAAAB+TFE1...",
      "qrUrl": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?...",
      "uuid": "bcda84ec-a5a7-4af3-a8fa-3c754b32711a",
      "aeat": {
        "Cabecera": {
          "IDVersion": "1.0",
          "Destinatario": {
            "NombreRazon": "ACME S.L.",
            "IDOtro": {
              "CodigoPais": "ES",
              "ID": "X1234567A",
              "IDType": "02"
            },
            "NIF": "B12345678"
          },
          "IndicadorRepresentante": "S",
          "ObligadoEmision": {
            "NombreRazon": "ACME S.L.",
            "IDOtro": {
              "CodigoPais": "ES",
              "ID": "X1234567A",
              "IDType": "02"
            },
            "NIF": "B12345678"
          }
        },
        "ClavePaginacion": {
          "FechaExpedicionFactura": "15-06-2025",
          "IDEmisorFactura": "B12345678",
          "NumSerieFactura": "2025/00999"
        },
        "DatosPresentacion": {
          "NIFPresentador": "B12345678",
          "TimestampPresentacion": "2024-01-01T19:20:30+01:00",
          "IdPeticion": "a1b2c3d4e5"
        },
        "IdPeticion": "a1b2c3d4e5",
        "IndicadorPaginacion": "N",
        "PeriodoImputacion": {
          "Ejercicio": "2025",
          "Periodo": "12"
        },
        "RegistroRespuestaConsultaFactuSistemaFacturacion": [
          {
            "IDFactura": {
              "FechaExpedicionFactura": "15-06-2025",
              "IDEmisorFactura": "B12345678",
              "NumSerieFactura": "2025/00999"
            },
            "DatosPresentacion": {
              "NIFPresentador": "B12345678",
              "TimestampPresentacion": "2024-01-01T19:20:30+01:00",
              "IdPeticion": "a1b2c3d4e5"
            },
            "DatosRegistroFacturacion": {
              "CuotaTotal": "210.00",
              "Cupon": "<string>",
              "DescripcionOperacion": "Servicios de consultoría",
              "Desglose": {
                "DetalleDesglose": [
                  {
                    "BaseImponibleOimporteNoSujeto": "1000.00",
                    "BaseImponibleACoste": "800.00",
                    "CalificacionOperacion": "S1",
                    "ClaveRegimen": "01",
                    "CuotaRecargoEquivalencia": "52.00",
                    "CuotaRepercutida": "210.00",
                    "Impuesto": "01",
                    "OperacionExenta": "E1",
                    "TipoImpositivo": "21",
                    "TipoRecargoEquivalencia": "5.2"
                  }
                ]
              },
              "Destinatarios": {
                "IDDestinatario": [
                  {
                    "NombreRazon": "ACME S.L.",
                    "IDOtro": {
                      "CodigoPais": "ES",
                      "ID": "X1234567A",
                      "IDType": "02"
                    },
                    "NIF": "B12345678"
                  }
                ]
              },
              "EmitidaPorTerceroODestinatario": "<string>",
              "Encadenamiento": {
                "PrimerRegistro": "S",
                "RegistroAnterior": {
                  "FechaExpedicionFactura": "15-06-2025",
                  "Huella": "ABCD1234...",
                  "IDEmisorFactura": "B12345678",
                  "NumSerieFactura": "2025/00999"
                }
              },
              "FacturaSimplificadaArt7273": "<string>",
              "FacturaSinIdentifDestinatarioArt61d": "<string>",
              "FacturasRectificadas": {
                "IDFacturaRectificada": [
                  {
                    "FechaExpedicionFactura": "15-06-2025",
                    "IDEmisorFactura": "B12345678",
                    "NumSerieFactura": "2025/00999"
                  }
                ]
              },
              "FacturasSustituidas": {
                "IDFacturaSustituida": [
                  {
                    "FechaExpedicionFactura": "15-06-2025",
                    "IDEmisorFactura": "B12345678",
                    "NumSerieFactura": "2025/00999"
                  }
                ]
              },
              "FechaHoraHusoGenRegistro": "2024-01-01T19:20:30+01:00",
              "FechaOperacion": "15-06-2025",
              "Huella": "ABCD1234...",
              "ImporteRectificacion": {
                "BaseRectificada": "100.00",
                "CuotaRectificada": "21.00",
                "CuotaRecargoRectificado": "5.00"
              },
              "ImporteTotal": "1210.00",
              "Incidencia": "N",
              "Macrodato": "<string>",
              "NombreRazonEmisor": "ACME S.L.",
              "RechazoPrevio": "N",
              "RefExterna": "EXT-REF-001",
              "SinRegistroPrevio": "N",
              "SistemaInformatico": {
                "IdSistemaInformatico": "AA",
                "NombreRazon": "ACME S.L.",
                "NumeroInstalacion": "0001",
                "IDOtro": {
                  "CodigoPais": "ES",
                  "ID": "X1234567A",
                  "IDType": "02"
                },
                "IndicadorMultiplesOT": "N",
                "NIF": "B12345678",
                "NombreSistemaInformatico": "MiSIF",
                "TipoUsoPosibleMultiOT": "N",
                "TipoUsoPosibleSoloVerifactu": "S",
                "Version": "1.0.0"
              },
              "Subsanacion": "S",
              "Tercero": {
                "NombreRazon": "ACME S.L.",
                "IDOtro": {
                  "CodigoPais": "ES",
                  "ID": "X1234567A",
                  "IDType": "02"
                },
                "NIF": "B12345678"
              },
              "TipoFactura": "F1",
              "TipoRectificativa": "S"
            },
            "EstadoRegistro": {
              "CodigoErrorRegistro": "4104",
              "DescripcionErrorRegistro": "Codigo[4104]. The NIF of the holder in the header is not identified.",
              "EstadoRegistro": "Correcto",
              "TimestampUltimaModificacion": "2024-01-01T19:20:30+01:00"
            }
          }
        ],
        "ResultadoConsulta": "ConDatos"
      },
      "corrected_invoices": [
        {
          "issue_date": "2024-02-01",
          "num_serie": "INV2024-0005"
        }
      ],
      "corrective_amount": {
        "corrected_fee": "210.00",
        "rectified_base": "1000.00",
        "corrected_surcharge_fee": "52.00"
      },
      "corrective_type": "S",
      "description": "<string>",
      "encadenamiento": {
        "huella": "ABCD1234...",
        "issue_date": "2024-01-15",
        "nif_emisor": "B12345678",
        "num_serie": "INV2024-0001",
        "PrimerRegistro": "S"
      },
      "error_code": 1234,
      "error_description": "<string>",
      "fecha_huso": "2024-01-15T10:23:45+01:00",
      "huella": "<string>",
      "id_otro": {
        "country_code": "ES",
        "id": "X1234567A",
        "id_type": "02"
      },
      "incidence": "<string>",
      "invoice_type": "F1",
      "issue_date": "2024-01-15",
      "lines": [
        {
          "taxable_base": "1000.00",
          "equivalent_surcharge_fee": "<string>",
          "equivalent_surcharge_type": "<string>",
          "exempt_operation": "E1",
          "fee_charged": "210.00",
          "operation_rating": "S1",
          "system_key": "01",
          "tax": "01",
          "tax_rate": "21",
          "taxable_base_at_cost": "<string>"
        }
      ],
      "name": "<string>",
      "NIF": "<string>",
      "nombre_razon_emisor": "<string>",
      "previous_rejection": "<string>",
      "ref_externa": "<string>",
      "replaced_invoices": [
        {
          "issue_date": "2024-02-01",
          "num_serie": "INV2024-0005"
        }
      ],
      "special": {
        "coupon": "S",
        "id_other_third": {
          "id": "FR123456789",
          "id_type": "02",
          "country_code": "FR"
        },
        "invoice_without_recipient_id_art_61d": "S",
        "issued_by_third_party_or_recipient": "T",
        "simplified_invoice_art_7273": "S",
        "third_party_name": "<string>",
        "third_party_nif": "<string>"
      },
      "status": "Correcto",
      "subsanacion": "S",
      "timestamp": "2024-01-15T10:23:45Z",
      "total_amount": 121.5,
      "total_fee": 21.5,
      "without_prior_registration": "<string>"
    }
  ],
  "pagination": true,
  "totalRecords": 125,
  "aeat": {
    "Cabecera": {
      "IDVersion": "1.0",
      "Destinatario": {
        "NombreRazon": "ACME S.L.",
        "IDOtro": {
          "CodigoPais": "ES",
          "ID": "X1234567A",
          "IDType": "02"
        },
        "NIF": "B12345678"
      },
      "IndicadorRepresentante": "S",
      "ObligadoEmision": {
        "NombreRazon": "ACME S.L.",
        "IDOtro": {
          "CodigoPais": "ES",
          "ID": "X1234567A",
          "IDType": "02"
        },
        "NIF": "B12345678"
      }
    },
    "ClavePaginacion": {
      "FechaExpedicionFactura": "15-06-2025",
      "IDEmisorFactura": "B12345678",
      "NumSerieFactura": "2025/00999"
    },
    "DatosPresentacion": {
      "NIFPresentador": "B12345678",
      "TimestampPresentacion": "2024-01-01T19:20:30+01:00",
      "IdPeticion": "a1b2c3d4e5"
    },
    "IdPeticion": "a1b2c3d4e5",
    "IndicadorPaginacion": "N",
    "PeriodoImputacion": {
      "Ejercicio": "2025",
      "Periodo": "12"
    },
    "RegistroRespuestaConsultaFactuSistemaFacturacion": [
      {
        "IDFactura": {
          "FechaExpedicionFactura": "15-06-2025",
          "IDEmisorFactura": "B12345678",
          "NumSerieFactura": "2025/00999"
        },
        "DatosPresentacion": {
          "NIFPresentador": "B12345678",
          "TimestampPresentacion": "2024-01-01T19:20:30+01:00",
          "IdPeticion": "a1b2c3d4e5"
        },
        "DatosRegistroFacturacion": {
          "CuotaTotal": "210.00",
          "Cupon": "<string>",
          "DescripcionOperacion": "Servicios de consultoría",
          "Desglose": {
            "DetalleDesglose": [
              {
                "BaseImponibleOimporteNoSujeto": "1000.00",
                "BaseImponibleACoste": "800.00",
                "CalificacionOperacion": "S1",
                "ClaveRegimen": "01",
                "CuotaRecargoEquivalencia": "52.00",
                "CuotaRepercutida": "210.00",
                "Impuesto": "01",
                "OperacionExenta": "E1",
                "TipoImpositivo": "21",
                "TipoRecargoEquivalencia": "5.2"
              }
            ]
          },
          "Destinatarios": {
            "IDDestinatario": [
              {
                "NombreRazon": "ACME S.L.",
                "IDOtro": {
                  "CodigoPais": "ES",
                  "ID": "X1234567A",
                  "IDType": "02"
                },
                "NIF": "B12345678"
              }
            ]
          },
          "EmitidaPorTerceroODestinatario": "<string>",
          "Encadenamiento": {
            "PrimerRegistro": "S",
            "RegistroAnterior": {
              "FechaExpedicionFactura": "15-06-2025",
              "Huella": "ABCD1234...",
              "IDEmisorFactura": "B12345678",
              "NumSerieFactura": "2025/00999"
            }
          },
          "FacturaSimplificadaArt7273": "<string>",
          "FacturaSinIdentifDestinatarioArt61d": "<string>",
          "FacturasRectificadas": {
            "IDFacturaRectificada": [
              {
                "FechaExpedicionFactura": "15-06-2025",
                "IDEmisorFactura": "B12345678",
                "NumSerieFactura": "2025/00999"
              }
            ]
          },
          "FacturasSustituidas": {
            "IDFacturaSustituida": [
              {
                "FechaExpedicionFactura": "15-06-2025",
                "IDEmisorFactura": "B12345678",
                "NumSerieFactura": "2025/00999"
              }
            ]
          },
          "FechaHoraHusoGenRegistro": "2024-01-01T19:20:30+01:00",
          "FechaOperacion": "15-06-2025",
          "Huella": "ABCD1234...",
          "ImporteRectificacion": {
            "BaseRectificada": "100.00",
            "CuotaRectificada": "21.00",
            "CuotaRecargoRectificado": "5.00"
          },
          "ImporteTotal": "1210.00",
          "Incidencia": "N",
          "Macrodato": "<string>",
          "NombreRazonEmisor": "ACME S.L.",
          "RechazoPrevio": "N",
          "RefExterna": "EXT-REF-001",
          "SinRegistroPrevio": "N",
          "SistemaInformatico": {
            "IdSistemaInformatico": "AA",
            "NombreRazon": "ACME S.L.",
            "NumeroInstalacion": "0001",
            "IDOtro": {
              "CodigoPais": "ES",
              "ID": "X1234567A",
              "IDType": "02"
            },
            "IndicadorMultiplesOT": "N",
            "NIF": "B12345678",
            "NombreSistemaInformatico": "MiSIF",
            "TipoUsoPosibleMultiOT": "N",
            "TipoUsoPosibleSoloVerifactu": "S",
            "Version": "1.0.0"
          },
          "Subsanacion": "S",
          "Tercero": {
            "NombreRazon": "ACME S.L.",
            "IDOtro": {
              "CodigoPais": "ES",
              "ID": "X1234567A",
              "IDType": "02"
            },
            "NIF": "B12345678"
          },
          "TipoFactura": "F1",
          "TipoRectificativa": "S"
        },
        "EstadoRegistro": {
          "CodigoErrorRegistro": "4104",
          "DescripcionErrorRegistro": "Codigo[4104]. The NIF of the holder in the header is not identified.",
          "EstadoRegistro": "Correcto",
          "TimestampUltimaModificacion": "2024-01-01T19:20:30+01:00"
        }
      }
    ],
    "ResultadoConsulta": "ConDatos"
  },
  "indicadorPaginacion": "N",
  "nextPagination": {
    "issue_date": "15-06-2025",
    "issuer_nif": "B12345678",
    "serial_number": "2025/00999"
  },
  "resultadoConsulta": "ConDatos"
}

Autorizaciones

​
Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de consulta

​
exercise
string
requerido

Fiscal year of the invoices (usually the year of operation_date or issue_date)

Ejemplo:

"2025"

​
period
string
requerido

Periodo (mes) de consulta: "01" a "12"

Ejemplo:

"12"

​
series
string

Invoice series. Optional. Can be empty string (""). Must not begin with a space.

Ejemplo:

"A"

​
number
string

Invoice number. Optional. If series is provided (non-empty), number is required.

Ejemplo:

"2025/00123"

​
issue_date_range
object

Date range filter by issue date range. Takes priority over single issue_date

​
issue_date
string

Single issue date filter (DD-MM-YYYY). Ignored if issue_date_range is used)

Ejemplo:

"07-12-2025"

​
pagination
object

Required only for pagination when >10,000 records

​
query_type
enum<string>
predeterminado:OBLIGADO

Tipo de consulta: OBLIGADO (consulta como emisor) o DESTINATARIO (consulta como destinatario)

Opciones disponibles:
OBLIGADO,
DESTINATARIO
​
counterparty
object

Contraparte de la consulta (destinatario si consulta el obligado; obligado si consulta el destinatario)

​
representative
enum<string>

IndicadorRepresentante: S si quien consulta es representante/asesor (solo con query_type=OBLIGADO)

Opciones disponibles:
S
​
show_issuer_name
enum<string>

MostrarNombreRazonEmisor: incluye NombreRazonEmisor en la respuesta (S/N)

Opciones disponibles:
S,
N
​
show_system
enum<string>

MostrarSistemaInformatico: incluye SistemaInformatico en la respuesta (S/N). No permitido con query_type=DESTINATARIO

Opciones disponibles:
S,
N
​
system
object

Filtro por SistemaInformatico (SIF)

​
external_ref
string

RefExterna: referencia externa del registro (máx 60)

Maximum string length: 60

Respuesta

List of invoices successfully retrieved

​
correlationId
string
requerido

Correlation ID for tracking the request

Ejemplo:

"123e4567-e89b-12d3-a456-426614174000"

​
data
object[]
requerido

List of invoice status records

​
pagination
boolean
requerido

Indicates if there are more pages of results

Ejemplo:

true

​
totalRecords
number
requerido

Total number of records found for the query

Ejemplo:

125

​
aeat
object

Respuesta AEAT completa tipada (ConsultaLR)

​
indicadorPaginacion
enum<string>

IndicadorPaginacion devuelto por AEAT (S/N)

Opciones disponibles:
S,
N
Ejemplo:

"N"

​
nextPagination
object

ClavePaginacion devuelta por AEAT para solicitar la siguiente página

​
resultadoConsulta
enum<string>

ResultadoConsulta devuelto por AEAT (ConDatos/SinDatos)

Opciones disponibles:
ConDatos,
SinDatos
Ejemplo:

"ConDatos"