Llista el registre de peticions de la teva API
Inspecciona les peticions que la teva pròpia integració ha fet contra aquesta API, de més recent a més antiga, per depurar-la sense obrir un tiquet de suport: què has cridat, què t'ha retornat, quant ha trigat i, quan una crida ha fallat, l'error que ha retornat. Acotat a l'empresa autenticada. Les files es purguen als 30 dies, així que això és una finestra de depuració, no un rastre d'auditoria.
A: header
Paràmetres de consulta
Mètodes HTTP pels quals filtrar, separats per comes (?method=GET,POST) o repetits (?method[]=GET&method[]=POST). Valors admesos: GET, POST, PUT, PATCH, DELETE. Qualsevol altre valor retorna 422 — el filtre mai no es descarta en silenci.
"GET" | "POST" | "PUT" | "PATCH" | "DELETE"Rangs de codi d'estat pels quals filtrar, separats per comes (?status_range=4xx,5xx) o repetits (?status_range[]=4xx&status_range[]=5xx). Valors admesos: 2xx, 3xx, 4xx, 5xx. Qualsevol altre valor retorna 422. only_errors=true és una drecera de 4xx,5xx, però un status_range explícit mana per damunt.
"2xx" | "3xx" | "4xx" | "5xx"Drecera de status_range=4xx,5xx. Un status_range explícit mana per damunt.
Primers caràcters de l'identificador de l'API key que ha fet la petició.
length <= 64Coincidència parcial, sense distingir majúscules, contra la ruta de la petició.
length <= 255Límit inferior inclusiu de created_at (ISO 8601).
date-timeLímit superior inclusiu de created_at (ISO 8601).
date-timeEntorn de l'API key que ha fet la petició (live, test).
"live" | "test"Nombre de registres a retornar. Enter entre 1 i 100. Per defecte 50 (més ampli que la resta de llistats de v1, que van a 25). Un valor no enter o fora de rang retorna 400.
501 <= value <= 100Cursor de paginació cap endavant: torna a enviar el next_cursor de la pàgina anterior. Tracta'l com a opac — a diferència de la resta de llistats de v1 és una cadena numèrica, no un UUID v7, perquè els registres de peticions no tenen UUID. Un cursor mal format retorna 400.
^[0-9]+$Paràmetres de capçalera
Fixa la versió de l'API (YYYY-MM-DD, versionat per data estil Stripe) per a aquesta petició; omet-lo per usar la versió fixada de la clau, o l'última si no n'hi ha cap. Versió no suportada → 400 unsupported_api_version; mal formada → 400 parameter_invalid_format. La versió efectiva es reflecteix a la capçalera de resposta Factuarea-Version. Consulta la guia de Versioning.
dateOpera en nom d'una empresa filla (API key mestra de gestoria): passa el seu id públic (UUID v7) i la petició s'executa contra les dades d'aquella filla sense canviar l'scope, el tier ni l'environment de la clau (omet-lo per usar la pròpia empresa de la clau). UUID no vàlid → 400 parameter_invalid_uuid; id desconegut o no propi → 404 profile_not_found. Consulta la guia d'Acting on behalf.
uuidCos de la resposta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
import { Factuarea } from "@factuarea/sdk";const factuarea = new Factuarea({ apiKey: process.env.FACTUAREA_API_KEY! });// List endpoints return an async-iterable Page (cursors handled for you).for await (const item of await factuarea.developers.requestLogs.list({ limit: 25 })) { console.log(item.id);}{
"data": [
{
"request_id": "req_01JQZP8K4M9N2T5V7X0Y3B6D8F",
"object": "api_request_log",
"api_key_prefix": "01931b3e",
"method": "POST",
"path": "/v1/invoices",
"status_code": 422,
"duration_ms": 143,
"ip": "203.0.113.24",
"user_agent": "factuarea-cli/0.1.3",
"error_type": "invalid_request_error",
"error_code": "invalid_param_value",
"factuarea_version": "2026-06-01",
"environment": "live",
"created_at": "2026-07-15T09:30:12+00:00"
}
],
"has_more": true,
"next_cursor": "184320"
}{
"error": {
"type": "invalid_request_error",
"code": "parameter_unknown",
"message": "El parámetro 'per_page' no está reconocido por este endpoint.",
"param": "per_page",
"doc_url": "https://docs.factuarea.com/guides/errors#parameter_unknown",
"request_id": "req_01HKQS5N7UR6PWJ8K2T5BWPMZ9"
}
}{
"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": "invalid_request_error",
"code": "parameter_invalid",
"message": "El campo `name` es obligatorio y no puede estar vacío.",
"param": "name",
"doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid",
"request_id": "req_01HKQS5NGS8Z3T6Q1D2E7FYVSI"
}
}{
"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"
}
}