Factuarea API
VeriFactu (AEAT)

Listar certificados de la empresa

Lista los certificados FNMT (PKCS#12) subidos de tu empresa. La contraseña del certificado nunca se expone en esta representación.

GET
/verifactu/certificates

Authorization

AuthorizationBearer <token>

En: header

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

{
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a13",
      "object": "verifactu_certificate",
      "subject_nif": "B12345678",
      "subject_name": "Acme Corporation SL",
      "subject_kind": "juridica",
      "valid_from": "2026-01-01T00:00:00+01:00",
      "valid_to": "2029-01-01T00:00:00+01:00",
      "is_active": true,
      "revoked_at": null,
      "created_at": "2026-01-10T09:00:00+01:00"
    }
  ]
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Recupera el certificado activo

Devuelve el certificado FNMT actualmente activo usado para firmar las transmisiones VeriFactu. Devuelve 404 si aún no se ha subido ningún certificado.

Revoca un certificado de empresa

Revoca (elimina) un certificado de la empresa para que ya no pueda firmar transmisiones VeriFactu. Devuelve 404 si el certificado no existe en tu empresa.