Account

Read your API access log

Every authenticated request made with a key on this account, in this environment, newest first. The audit answer to "who used our key, against what, and when" — including the refusals, which is usually the half worth reading.

Rows carry the source IP the edge observed, the user agent, the key that was used, the HTTP status, the machine error_code on a refusal, and the request_id you were given at the time, so a line here joins directly to your own logs and to any support conversation about it.

Unauthenticated requests are absent by construction: a rejected key carries no account to attribute it to. Calls that set the synthetic header ARE recorded — the header is caller-supplied, and an audit log you can opt out of by sending a header is not an audit log. Retained for 365 days.

Required scope: logs:read.

get/api/v1/access-log

Request

  • Base URL: https://arcnautical.com
  • URL: https://arcnautical.com/api/v1/access-log
  • Auth: one of:
    • HTTP bearer
    • API key in header X-ArcNautical-Key

Query parameters

limitinteger

Rows per page, 1-200. Default 50.

cursorstring

next_cursor from the previous page, unmodified.

statusinteger

One HTTP status code, for example 403.

outcome'success' | 'failure'

success (status under 400) or failure (400 and above).

methodstring

One HTTP method.

endpointstring

Templated path with ids collapsed, for example /api/v1/screenings/{id}.

key_idstring uuid

Only calls made with this key. The key id from the developer portal, never the key itself.

created_afterstring date-time

ISO 8601 lower bound, inclusive.

created_beforestring date-time

ISO 8601 upper bound, inclusive.

Response

Successful response.

next_cursorstring nullable
has_moreboolean required
environment'live' | 'test' required
retention_daysinteger required

How far back this log reaches.

notestring

Changes

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