---
title: "List Rule Logs V2"
method: GET
path: "/api/v1/runs/rules/{rule_id}/logs/v2"
tags: ["run"]
---

# List Rule Logs V2

`GET /api/v1/runs/rules/{rule_id}/logs/v2`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v1/runs/rules/{rule_id}/logs/v2`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Tenant-Id`
  - HTTP bearer

List logs for a particular rule with cursor-based pagination.

This endpoint handles S3-stored outcomes correctly by using run_outcomes_count
to predict batch sizes and avoid over-fetching.

## Path parameters

- `rule_id` string, uuid, required

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `backfill` boolean
- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable
- `session_id` string, uuid, nullable

## Response `200`

Successful Response

- RuleLogsPaginatedResponse: Paginated response for rule logs with cursor-based pagination.
  - `logs` RuleLogSchema[], required
    - `rule_id` string, uuid, required
    - `run_id` string, uuid, required
    - `run_name` string, nullable
    - `run_type` string, nullable
    - `run_session_id` string, uuid, nullable
    - `run_trace_id` string, uuid, nullable
    - `start_time` string, date-time, required
    - `end_time` string, date-time, required
    - `application_time` string, date-time, nullable
    - `add_to_annotation_queue` RuleLogActionResponse
      - `outcome` 'success' | 'skipped' | 'error', required
      - `payload` object, nullable
    - `add_to_dataset` RuleLogActionResponse
      - `outcome` 'success' | 'skipped' | 'error', required
      - `payload` object, nullable
    - `evaluators` RuleLogActionResponse
      - `outcome` 'success' | 'skipped' | 'error', required
      - `payload` object, nullable
    - `alerts` RuleLogActionResponse
      - `outcome` 'success' | 'skipped' | 'error', required
      - `payload` object, nullable
    - `webhooks` RuleLogActionResponse
      - `outcome` 'success' | 'skipped' | 'error', required
      - `payload` object, nullable
    - `extend_only` RuleLogActionResponse
      - `outcome` 'success' | 'skipped' | 'error', required
      - `payload` object, nullable
    - `thread_id` string, nullable
  - `cursor` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `1a8ee9358d81`: 4 breaking, 1 info
  - the `detail/items/` response's property type changed from `object` to `string` for status `422`
  - removed the required property `detail/items/loc` from the response with the `422` status
  - removed the required property `detail/items/msg` from the response with the `422` status
  - removed the required property `detail/items/type` from the response with the `422` status
  - …1 more
- **2026-05-27** `a0acb3a6a101`: 1 breaking, 1 info
  - removed the required property `has_more` from the response with the `200` status
  - added the optional property `logs/items/extend_only` to the response with the `200` status

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/runs/rules/:rule_id/logs/v2/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)