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.

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de consulta

method[]?array<>

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.

Valor a"GET" | "POST" | "PUT" | "PATCH" | "DELETE"

status_range[]?array<>

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.

Valor a"2xx" | "3xx" | "4xx" | "5xx"

only_errors?boolean

Drecera de status_range=4xx,5xx. Un status_range explícit mana per damunt.

api_key_prefix?string

Primers caràcters de l'identificador de l'API key que ha fet la petició.

Longitudlength <= 64

path_search?string

Coincidència parcial, sense distingir majúscules, contra la ruta de la petició.

Longitudlength <= 255

created_at[gte]?string

Límit inferior inclusiu de created_at (ISO 8601).

Formatdate-time

created_at[lte]?string

Límit superior inclusiu de created_at (ISO 8601).

Formatdate-time

environment?string

Entorn de l'API key que ha fet la petició (live, test).

Valor a"live" | "test"

limit?integer

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.

Predeterminat50

Rang1 <= value <= 100

starting_after?string

Cursor 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.

Coincidència^[0-9]+$

Headers

Factuarea-Version?string

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.

Formatdate

X-Active-Profile?string

Opera 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.

Formatuuid

Cos de la resposta

`application/json`

Exemple de petició

const apiKey = process.env.FACTUAREA_API_KEY;if (!apiKey) throw new Error("Set FACTUAREA_API_KEY");const response = await fetch("https://api.factuarea.com/v1/developers/request-logs?limit=50", {  method: "GET",  headers: { Authorization: `Bearer ${apiKey}`, ...{"Accept":"application/json"} },});if (!response.ok) throw new Error(await response.text());if (response.status !== 204) console.log(await response.json());

Exemple de resposta

{
  "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": false,
  "next_cursor": null
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_invalid_range",
    "message": "El parámetro 'limit' debe estar entre 1 y 100, recibido: 500.",
    "param": "limit",
    "doc_url": "https://docs.factuarea.com/guides/errors#parameter_invalid_range",
    "request_id": "req_9687181bbf475b46884449eb8f"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "Falta header Authorization o X-API-Key.",
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_877db558a5fa340b5ee32256b0"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta operación requiere el scope 'developers:read'. Tu API key solo tiene los scopes: ninguno.",
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_2f47a99c51c9e437228414f01a"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_param_value",
    "message": "El campo method[] no tiene un valor válido.",
    "param": "method[]",
    "errors": [
      {
        "param": "method[]",
        "code": "parameter_invalid_value",
        "message": "El campo method[] no tiene un valor válido."
      }
    ],
    "doc_url": "https://docs.factuarea.com/guides/errors#invalid_param_value",
    "request_id": "req_968ea44b0315e8a65f05bd61e4"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el límite de requests permitido. Reintenta más tarde.",
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_78ce0d04ce7145f3bbc8036534"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Algo se rompió en nuestro lado al procesar la petición. La condición no la provoca tu payload.",
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_575d90bdc0eaec8ff47c35ff3c"
  }
}

Llista el registre de peticions de la teva API

Authorization

Paràmetres de consulta

Headers

Cos de la resposta

200application/json

400application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`