---
title: "Get Traces"
method: GET
path: "/api/v1/monitor/traces"
tags: ["Traces"]
---

# Get Traces

`GET /api/v1/monitor/traces`

Get list of traces for a flow.

Args:
    current_user: Authenticated user (required for authorization)
    flow_id: Filter by flow ID
    session_id: Filter by session ID
    status: Filter by trace status
    query: Search query for trace name/id/session id
    start_time: Filter traces starting on/after this time (ISO)
    end_time: Filter traces starting on/before this time (ISO)
    page: Page number (1-based)
    size: Page size

Returns:
    List of traces

## Query parameters

- `flow_id` string, uuid, nullable
- `session_id` string, nullable
- `status` 'unset' | 'ok' | 'error' — OpenTelemetry status codes. - UNSET: Default status, span has not ended yet - OK: Span completed successfully - ERROR: Span completed with an error
- `query` string, nullable
- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable
- `page` integer
- `size` integer

## Response `200`

Successful Response

- TraceListResponse — Paginated list response for traces.
  - `pages` integer, required
  - `total` integer, required
  - `traces` TraceSummaryRead[], required
    - `flowId` string, uuid, required
    - `id` string, uuid, required
    - `input` union
      - object
      - string
    - `name` string, required
    - `output` union
      - object
      - string
    - `sessionId` string, required
    - `startTime` string, date-time, nullable, required
    - `status` 'unset' | 'ok' | 'error', required — OpenTelemetry status codes. - UNSET: Default status, span has not ended yet - OK: Span completed successfully - ERROR: Span completed with an error
    - `totalLatencyMs` integer, required
    - `totalTokens` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langflow-ai/apis/langflow.md) · [All operations](https://skmtc.net/langflow-ai/apis/langflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langflow-ai/langflow/revisions/22962dc5e81b/schema)