---
title: "List execution traces — audit recent broker and workflow calls"
method: GET
path: "/traces"
tags: ["observe"]
---

# List execution traces — audit recent broker and workflow calls

`GET /traces`

Returns recent execution traces with status, capability id, toolkit, timestamp, and HTTP status. Use GET /traces/{trace_id} for step-level detail.

## Query parameters

- `limit` integer — Maximum number of traces to return (1-500)
- `offset` integer — Number of traces to skip for pagination

## Response `200`

Successful Response

- TraceListPage — Paginated list of execution traces for auditing recent broker and workflow calls.
  - `total` integer, required — Total number of traces matching the query
  - `limit` integer, required — Maximum traces returned in this response
  - `offset` integer, required — Starting offset for pagination (0-indexed)
  - `traces` TraceOut[], required — Array of trace records for this page
    - `id` string, required — Trace ID (format: exec_{12chars})
    - `toolkit_id` string, nullable — Toolkit that executed this capability
    - `operation_id` string, nullable — Operation capability ID (for single API calls)
    - `workflow_id` string, nullable — Workflow capability ID (for multi-step workflows)
    - `spec_path` string, nullable — Path to the OpenAPI spec or Arazzo workflow file
    - `status` string, required — Execution status: success, failed, or pending
    - `http_status` integer, nullable — Final HTTP status code from upstream
    - `duration_ms` integer, nullable — Total execution duration in milliseconds
    - `error` string, nullable — Error message if execution failed
    - `created_at` number, nullable — Unix timestamp when execution started
    - `completed_at` number, nullable — Unix timestamp when execution completed
    - `steps` TraceStepOut[] — Step-by-step execution log (for workflows)
      - `id` string, nullable — Internal step record ID
      - `step_id` string, nullable — Step identifier from the Arazzo workflow
      - `operation` string, nullable — Operation capability ID executed in this step
      - `status` string, nullable — Step status: success or failed
      - `http_status` integer, nullable — HTTP status code from this step's API call
      - `output` unknown
      - `detail` unknown
      - `error` string, nullable — Error message if step failed
      - `started_at` number, nullable — Unix timestamp when step started
      - `completed_at` number, nullable — Unix timestamp when step completed

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-13** `76e8f6063728` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/jentic/apis/jentic-control-plane-api/changes/traces/get.md)

---

[API](https://skmtc.dev/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.dev/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/revisions/bd463fcefb14/schema)