Tus credenciales sirven para dos cosas

Plataforma

Inicia sesión en app.verifactuapi.es para ver tus registros, emisores y envíos a la AEAT.

API

El mismo usuario y contraseña se usan en POST /api/login para obtener el token con el que autenticas cada llamada.

3 pasos hasta tu primera factura verificada

01

Login — Obtén tu token

Autentícate con el email y contraseña de tu cuenta para recibir un token temporal.

curl --request POST \
  "https://app.verifactuapi.es/api/login" \
  --header "Content-Type: application/json" \
  --data '{
    "email": "tu_email@empresa.com",
    "password": "tu_contraseña"
  }'

02

Alta — Registra tu primera factura

Llama a POST /api/alta-registro-facturacion con los datos mínimos. La respuesta trae el Id del registro y el QR ya generado.✓ qr_image llega en base64, listo para imprimir

curl --request POST \
  "https://app.verifactuapi.es/api/alta-registro-facturacion" \
  --header "Authorization: Bearer {token}" \
  --header "Content-Type: application/json" \
  --data '{
    "IDEmisorFactura": "A39200019",
    "NumSerieFactura": "2026/001",
    "FechaExpedicionFactura": "2026-07-22",
    "TipoFactura": "F1",
    "DescripcionOperacion": "Servicios de consultoría",
    "Destinatarios": [
      { "NombreRazon": "Cliente de prueba", "NIF": "39707287H" }
    ],
    "Desglose": [
      { "Impuesto": 1, "ClaveRegimen": 1, "CalificacionOperacion": 1,
        "TipoImpositivo": 21, "BaseImponibleOImporteNoSujeto": 100,
        "CuotaRepercutida": 21 }
    ],
    "CuotaTotal": 21,
    "ImporteTotal": 121
  }'

03

Consulta — Confirma el envío a la AEAT

Con el Id obtenido en el paso anterior, consulta el registro para ver el Hash de Encadenamiento y el estado de confirmación de la AEAT.

curl --request GET \
  "https://app.verifactuapi.es/api/alta-registro-facturacion/{id}" \
  --header "Authorization: Bearer {token}"

# Respuesta incluye:
#   "estado_aeat": "Correcto",
#   "Huella": "6FD01AD6D7CA3136A0A9CD9FD4F01B71...",
#   "url_qr": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?..."

Claves para una prueba correcta

AVISO: Lee esto antes de empezar

Las pruebas sólo se ejecutan contra el entorno de Pruebas de VeriFactu de la AEAT, nunca contra producción.
El NIF/CIF emisor debe ser real, o la AEAT marcará el registro como "Incorrecta". Si prefieres no usar el tuyo, usa el CIF de pruebas A39200019.
Los datos del destinatario también deben ser reales, por el mismo motivo.
La AEAT procesa los envíos en ciclos de 60 segundos — el estado del registro puede tardar ese tiempo en actualizarse.