Account

List your account API request logs

List the requests made with ANY API key of your account, newest first, in the credential’s environment.

  • Filters: method, status_range, only_errors, api_key_prefix, path_search, created_at[gte|lte]; cursor is starting_after.
  • Rows are purged after 30 days. Needs a credential reaching every tax ID, issued by an owner or admin.
get/accounts/{account}/request-logs

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/accounts/{account}/request-logs
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

accountstring uuid required

Public identifier (UUID v7) of your account. Get it from GET /v1/me (data.account.id).

Query parameters

method[]string[]

HTTP methods, comma-separated (?method=GET,POST) or repeated: GET, POST, PUT, PATCH or DELETE; any other value returns 422.

status_range[]string[]

Status code ranges, comma-separated (?status_range=4xx,5xx) or repeated: 2xx, 3xx, 4xx or 5xx; it wins over only_errors=true (shorthand for 4xx,5xx).

only_errorsboolean

Shortcut for status_range=4xx,5xx. An explicit status_range wins over it.

api_key_prefixstring

First characters of the API key identifier that issued the request.

path_searchstring

Partial, case-insensitive match against the request path.

created_at[gte]string date-time

Inclusive lower bound of created_at (ISO 8601).

created_at[lte]string date-time

Inclusive upper bound of created_at (ISO 8601).

relationship'own' | 'client'

Only requests on your own tax IDs (own) or on tax IDs of client accounts (client).

companystring uuid

Only requests on one company (its public id), which must be within your account's scope.

limitinteger

Number of logs to return, between 1 and 100 (default 50).

starting_afterstring
Example:184320

Cursor for forward pagination: the next_cursor of the previous page, an opaque numeric string (not a UUID v7). A malformed cursor returns 400.

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

ApiRequestLogListV1Resource

has_moreboolean required

true when more logs exist beyond this page.

next_cursorstring nullable required

Opaque cursor to pass as starting_after for the next page, or null when has_more is false. Unlike the rest of the v1 listings it is a numeric string, not a UUID v7 — treat it as opaque and reuse it verbatim.

Example response

{
  "data": [
    {
      "request_id": "req_01JQZP8K4M9N2T5V7X0Y3B6D8F",
      "object": "api_request_log",
      "api_key_prefix": "01931b3e",
      "method": "POST",
      "path": "/v1/companies/{company}/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",
      "company": {
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",
        "tax_id": "B12345674",
        "name": "Acme Soluciones SL"
      },
      "axis": "company"
    }
  ],
  "has_more": true,
  "next_cursor": "184320"
}

Changes

No recorded changes to this operation across all 1 revision of this API.