List Request Logs

Beta

GET/v1/core/request-logs

This endpoint is idempotent. Learn more

Returns a paginated list of request logs.

cursoroptional string

Query parameter: cursor for List Request Logs

limitoptional integer

Query parameter: limit for List Request Logs

qoptional string

Query parameter: q for List Request Logs

start_dateoptional string (date-time)

Filter: start of date range for occurred_at.

end_dateoptional string (date-time)

Filter: end of date range for occurred_at.

methodoptional string

Filter: HTTP method.

status_codeoptional integer

Filter: HTTP status code.

error_codeoptional string

Filter: API error code.

account_idoptional string

Filter: actor home account ID.

actor_idoptional string

Filter: actor ID.

actor_typeoptional string

Filter: actor type ("user" or "api_key").

actor_nameoptional string

Filter: actor name (partial or exact match).

exact_matchoptional boolean

When true, string filters use exact match instead of partial (LIKE).

include[]optional arrayenumValues:accountactoractor.role

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

objectstringenumValues:list

Object type for RequestLog list

page_infoobject

Pagination metadata for RequestLog list

next_cursorstringnullable

Cursor to fetch the next page, null if no more pages.

prev_cursorstringnullable

Cursor to fetch the previous page, null if on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of object

Array of RequestLog resources in this page

idstring

Request log ID.

objectstringenumValues:request_log

Resource type identifier.

methodstring

HTTP method.

hoststring

Request host.

pathstring

Request path.

normalized_routestring

Normalized route pattern.

query_jsonstringnullable

Query parameters as JSON.

status_codeinteger

HTTP status code.

latency_usinteger

Request latency in microseconds.

api_versionstringnullable

API version used.

identity_typestringnullable

Caller identity type.

client_ipstringnullable

Client IP address.

user_agentstringnullable

User agent string.

referrerstringnullable

Referrer header.

error_codestringnullable

API error code.

error_messagestringnullable

Error message.

occurred_atstring (date-time)

When the request occurred.

created_atstring (date-time)

When the log entry was created.

accountobjectExpandablenullable

Account targeted by the request.

idstring

Account ID.

objectstringenumValues:account

Resource type identifier.

namestring

Display name.

default_billing_addressobjectnullable

Default billing address.

Always returned as null in this endpoint.

default_shipping_addressobjectnullable

Default shipping address.

Always returned as null in this endpoint.

brandingobjectnullable

Branding configuration.

Always returned as null in this endpoint.

portalobjectnullable

Portal configuration.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

actorobjectExpandablenullable

Actor details (user or API key).

idstring

Actor ID.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

namestringnullable

Display name.

handlestringnullable

Human-readable handle (email for users, redacted value for API keys, slug for agents).

roleobjectExpandablenullable

Assigned role.

idstring

Role ID.

objectstringenumValues:role

Resource type identifier.

namestring

Display name.

typestringenumValues:adminuserscanner

Role type code.

ownerobjectnullable

Owner of this resource.

Always returned as null in this endpoint.

permissionsarray of stringnullable

Permissions in {domain}:{action} format.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

idempotency_keystringnullable

User-provided idempotency key.

request_body_jsonstringnullable

Request body as JSON.

response_body_jsonstringnullable

Response body as JSON.

Responses

200

Successful response for List Request Logs

List Request Logs

curl API_HOST/v1/core/request-logs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1"

curl API_HOST/v1/core/request-logs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1"

200 example

{
  "object": "list",
  "page_info": {
    "next_cursor": "rq_01jm4r6700f8nwq3v5hx2d9ktp",
    "prev_cursor": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "rq_01jm4r6700f8nwq3v5hx2d9ktp",
      "object": "request_log",
      "method": "GET",
      "host": "https://api.augno.com",
      "path": "/v1/core/sandboxes",
      "normalized_route": "/v1/core/sandboxes",
      "query_json": null,
      "status_code": 200,
      "latency_us": 12345,
      "api_version": "2026-01-01",
      "identity_type": "user",
      "client_ip": "198.51.100.7",
      "user_agent": "Mozilla/5.0",
      "referrer": null,
      "error_code": null,
      "error_message": null,
      "occurred_at": "2026-05-10T00:00:00Z",
      "created_at": "2026-05-10T00:00:00Z",
      "account": {
        "id": "ac_01gf7a8200eaj8fke1xvw4h50x",
        "object": "account",
        "name": "Acme Inc.",
        "default_billing_address": null,
        "default_shipping_address": null,
        "branding": null,
        "portal": null,
        "created_at": "2026-05-10T00:00:00Z",
        "updated_at": "2026-05-10T00:23:00Z"
      },
      "actor": {
        "id": "us_01gf7a8200e9pvbd6bgyq395ae",
        "object": "actor",
        "type": "user",
        "name": "John Doe",
        "handle": "jdoe@augno.com",
        "role": {
          "id": "rl_01gf7a8200er3ar3pkfrb6kk29",
          "object": "role",
          "name": "Admin",
          "type": "admin",
          "owner": null,
          "permissions": [
            "customers:create",
            "customers:read",
            "customers:update",
            "customers:delete"
          ],
          "created_at": "2026-05-10T00:00:00Z",
          "updated_at": "2026-05-10T00:23:00Z"
        }
      },
      "idempotency_key": null,
      "request_body_json": null,
      "response_body_json": null
    }
  ]
}

{
  "object": "list",
  "page_info": {
    "next_cursor": "rq_01jm4r6700f8nwq3v5hx2d9ktp",
    "prev_cursor": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "rq_01jm4r6700f8nwq3v5hx2d9ktp",
      "object": "request_log",
      "method": "GET",
      "host": "https://api.augno.com",
      "path": "/v1/core/sandboxes",
      "normalized_route": "/v1/core/sandboxes",
      "query_json": null,
      "status_code": 200,
      "latency_us": 12345,
      "api_version": "2026-01-01",
      "identity_type": "user",
      "client_ip": "198.51.100.7",
      "user_agent": "Mozilla/5.0",
      "referrer": null,
      "error_code": null,
      "error_message": null,
      "occurred_at": "2026-05-10T00:00:00Z",
      "created_at": "2026-05-10T00:00:00Z",
      "account": {
        "id": "ac_01gf7a8200eaj8fke1xvw4h50x",
        "object": "account",
        "name": "Acme Inc.",
        "default_billing_address": null,
        "default_shipping_address": null,
        "branding": null,
        "portal": null,
        "created_at": "2026-05-10T00:00:00Z",
        "updated_at": "2026-05-10T00:23:00Z"
      },
      "actor": {
        "id": "us_01gf7a8200e9pvbd6bgyq395ae",
        "object": "actor",
        "type": "user",
        "name": "John Doe",
        "handle": "jdoe@augno.com",
        "role": {
          "id": "rl_01gf7a8200er3ar3pkfrb6kk29",
          "object": "role",
          "name": "Admin",
          "type": "admin",
          "owner": null,
          "permissions": [
            "customers:create",
            "customers:read",
            "customers:update",
            "customers:delete"
          ],
          "created_at": "2026-05-10T00:00:00Z",
          "updated_at": "2026-05-10T00:23:00Z"
        }
      },
      "idempotency_key": null,
      "request_body_json": null,
      "response_body_json": null
    }
  ]
}

List Request Logs

Query Parameters

Returns

Responses