Bitácora de acciones de la cuenta

GET/api/v1/account/audit

Cada cambio hecho con API key, sesión del panel o por factuROA: quién, qué evento, sobre qué registro, IP y resultado (success, failure o denied). Más reciente primero; se conserva un año. Nunca guarda el cuerpo de la petición. Solo administradores.

Parámetros de consulta

event_typestring
Ejemplo: document.invoice_created
user_idstring · uuid
entity_idstring
outcomestring
Valores: success, failure, denied.
fromstring · date
Ejemplo: 2026-11-01
tostring · date
Ejemplo: 2026-11-30
limitinteger
máximo 200, por defecto 50.
cursorstring
next_cursor de la página anterior

Respuestas

200OK

itemsarray<object>
+ Ver 19 campos− Ocultar 19 campos
- idstring · uuid
- event_typestring
  Ejemplo: document.invoice_created
- actor_typestring
  Valores: user · api_key · platform · system
- user_idstring · uuid
- user_emailstring
  Ejemplo: contador@casapos.co
- api_key_idstring · uuid
- api_key_namestring
  Ejemplo: default
- key_account_idstring · uuid
  Casa de software que actuó sobre esta cuenta
- methodstring
  Ejemplo: POST
- routestring
  Ejemplo: /documents/invoices
- entity_typestring
  Ejemplo: documents
- entity_idstring
- statusinteger
  Ejemplo: 202
- outcomestring
  Valores: success · failure · denied
- ipstring
  Ejemplo: 181.49.10.20
- user_agentstring
- request_idstring
- metadataobject<string, string>
- created_atstring · date-time
next_cursorstring
Vacío si no hay más páginas

400Datos inválidos (details trae los campos)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

403La cuenta no puede hacer esto (p. ej. no es casa de software: error.account.not_software_house, o la cuenta de Facturoa-Account no es hija: error.account.not_child)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring