---
title: "List request logs"
method: GET
path: "/org/logs"
tags: ["Logs"]
---

# List request logs

`GET /org/logs`

## Request

- Base URL: `https://api.context.dev/v1`
- URL: `https://api.context.dev/v1/org/logs`
- Auth: HTTP bearer

List your organization’s request logs with filters and pagination. Logs also include batch settlements and monitor runs.

## Query parameters

- `from` string, date-time: Only include requests at or after this ISO 8601 timestamp. Defaults to 24 hours before `to`.
- `to` string, date-time: Only include requests at or before this ISO 8601 timestamp. Defaults to now.
- `path` string: Filter by endpoint path, with or without the /v1 prefix.
- `key_id` string: Filter by the API key that made the request.
- `status_code` integer: Filter by exact HTTP status code.
- `error_code` string: Filter by the `error_code` returned in the response.
- `errors_only` boolean: Only include requests that returned a 4xx or 5xx status.
- `tags` string: Comma-separated request tags. Matches requests carrying any of them. Up to 20 tags, each 1-50 characters.
- `search` string: Case-insensitive substring match against the request query and body, e.g. a domain.
- `page` integer: Page number, starting at 1.
- `limit` integer: Number of log entries per page.

## Response `200`

A page of log entries

- ListLogsResponse
  - `data` LogEntry[], required: Log entries, newest first.
    - `request_id` string, required: Request ID of the logged API call.
    - `timestamp` string, date-time, required: When the request completed.
    - `method` string, required: HTTP method, or `MONITOR` / `BATCH` for monitor-run and batch-settlement entries.
    - `path` string, required: Endpoint path as called.
    - `status_code` integer, required: HTTP status code returned.
    - `error_code` string, nullable, required: The `error_code` from the response, or null on success.
    - `latency_ms` number, required: Server-side processing time in milliseconds.
    - `credits_used` integer, required: Credits charged for this request.
    - `key_id` string, nullable, required: ID of the API key that made the request.
    - `tags` string[], required: Request tags supplied by the caller.
    - `zdr` boolean, required: Whether the request was made under zero data retention.
  - `page` integer, required: Current page number.
  - `limit` integer, required: Entries per page.
  - `has_more` boolean, required: Whether a next page exists.
  - `key_metadata` KeyMetadata: Credits this request used and your remaining balance.
    - `credits_consumed` integer, required: Credits charged for this request.
    - `credits_remaining` integer, required: Credits remaining for your organization.
  - `request_id` string, uuid, required: Unique ID of this request, also in `X-Request-Id`. Include it when contacting support.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `429`: Rate limit exceeded (60 requests per minute per organization).
- `500`: Log storage is temporarily unavailable.

## Changes

- **2026-10-21** `61627728926b`: 4 warning
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `400`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `401`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `429`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `500`
- **2026-10-19** `4ddcf49b9fe5`: 4 info
  - added the optional property `error_data` to the response with the `400` status
  - added the optional property `error_data` to the response with the `401` status
  - added the optional property `error_data` to the response with the `429` status
  - added the optional property `error_data` to the response with the `500` status
- **2026-10-16** `2125f3e94e52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context/apis/brand-api/changes/org/logs/get.md)

---

[API](https://skmtc.dev/context/apis/brand-api.md) · [All operations](https://skmtc.dev/context/apis/brand-api/llms.txt) · [OpenAPI document](https://skmtc.dev/context/apis/brand-api/revisions/9e2ab7841fb1?raw)