Factuarea API
VeriFactu (AEAT)

Llistar certificats de l'empresa

Llista els certificats FNMT (PKCS#12) pujats de la teva empresa. La contrasenya del certificat mai no s'exposa en aquesta representació.

GET
/verifactu/certificates

Authorization

AuthorizationBearer <token>

A: header

Cos de la resposta

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 certificat actiu

Retorna el certificat FNMT actualment actiu usat per signar les transmissions VeriFactu. Retorna 404 si encara no s'ha pujat cap certificat.

Revoca un certificat d'empresa

Revoca (elimina) un certificat de l'empresa perquè ja no pugui signar transmissions VeriFactu. Retorna 404 si el certificat no existeix a la teva empresa.