List request logs | Runledger API

{
  "object": "string",
  "data": [
    {
      "id": "req_7Hc2Lq0vTz8d",
      "object": "string",
      "method": "POST",
      "path": "/v1/events",
      "status": 409,
      "idempotent_replayed": true,
      "api_version": "string",
      "duration_ms": 42,
      "livemode": true,
      "created_at": "2024-01-15T09:30:00Z",
      "error_code": "invalid_request",
      "idempotency_key": "string",
      "api_key_prefix": "rl_sk_test_4fK2",
      "dry_run": true,
      "actor": {
        "type": "user",
        "id": "usr_4tN8vB2cXk",
        "name": "Claude Code",
        "on_behalf_of": "usr_4tN8vB2cXk",
        "client": "claude-code"
      },
      "sdk": {
        "language": "typescript",
        "version": "0.1.0"
      },
      "request_body": {},
      "response_body": {}
    }
  ],
  "has_more": true,
  "next_cursor": "string",
  "total_count": 1,
  "total_count_approximate": true
}

Requests made with your keys in the last 30 days, newest first. Secrets in the bodies are redacted. A configuration write sent with Runledger-Dry-Run: true is logged like any other request and appears tagged Dry run, so you can tell a check from a change. The later real change has its own request, and its audit event has dry_run_preceded: true.

Authentication

AuthorizationBearer

A secret key (rl_sk_test_..., rl_sk_live_...) or a restricted key with limited scopes (rl_rk_test_..., rl_rk_live_...). A restricted key can carry agent: true and an expires_at, and is what a coding agent should hold. Keys end in a checksum so secret scanners can recognize them. People create, roll and revoke keys in the dashboard; GET /v1/api_keys lists them, masked.

Query parameters

statusintegerOptional

Only requests that returned this HTTP status.

error_codeenumOptional

Only requests that failed with this error code.

pathstringOptional

Only requests to this path, such as /v1/events.

idempotency_keystringOptional

Only requests sent with this idempotency key.

actor_typeenumOptional

Only requests made by this kind of actor, such as agent.

Allowed values:

actorstringOptional

Only requests made by this actor ID.

keystringOptional

Only requests made with this API key ID (key_...).

created_afterdatetimeOptional

Only objects created at or after this time.

created_beforedatetimeOptional

Only objects created before this time.

limitintegerOptional1-100Defaults to 20

Maximum number of objects to return, from 1 to 100.

cursorstringOptional

The next_cursor from the previous page.

includeenumOptional

Send total_count to add total_count to the list: how many objects match the filters across every page. The count is capped, and total_count_approximate: true says when the real number is higher. It is slower than a plain list, so ask for it when you show a number.

Allowed values:

Response

A page of request logs.

object"list"

datalist of objects

has_moreboolean

next_cursorstringOptional

total_countintegerOptional

Only with include=total_count. How many objects match the filters.

total_count_approximatebooleanOptional

Only with include=total_count. True when the count was capped and the real number is higher.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error