---
title: "Trace by correlation ID"
method: GET
path: "/v1/trace/{correlationId}"
tags: ["Events"]
---

# Trace by correlation ID

`GET /v1/trace/{correlationId}`

Trace events across multiple runs and services using a correlation ID.

Returns all events that share the same correlation ID, grouped by run.
Useful for debugging distributed agent workflows.

**Example use case**: Tracing a request across multiple microservices
```
GET /v1/trace/{correlationId}
```

## Path parameters

- `correlationId` string, required

## Query parameters

- `format` 'json' | 'tree'

## Response `200`

Events grouped by run with trace context

- object — Events grouped by run with trace context
  - `correlationId` string
  - `totalEvents` integer
  - `totalRuns` integer
  - `runs` object[]
    - `runId` string, nullable
    - `workflowName` string, nullable
    - `status` string, nullable
    - `events` object[]
      - `id` string
      - `actionName` string
      - `outcome` string
      - `explanation` string, nullable
      - `timestamp` string, date-time
  - `anomalies` object[]
    - `id` string
    - `type` string
    - `severity` string
    - `detectedAt` string, date-time

## Other responses

- `401` — Unauthorized
- `404` — No events found with this correlation ID

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/versions/2cb1567969ca/schema)