---
title: "GET /v1/telemetry/traces"
method: GET
path: "/v1/telemetry/traces"
tags: ["telemetry"]
---

# GET /v1/telemetry/traces

`GET /v1/telemetry/traces`

Get OpenTelemetry traces within a specified time window with flexible pagination options: Pass in only the end time to paginate backwards from there. Pass in a start time to paginate backwards from now until the start time. Pass in both to get resources within the time window. Choose to return in end_time order instead to view traces that completed in a window or since a time. Filter additionally by branch_ids or file_id.

## Query parameters

- `file_id` string, uuid
- `branch_ids` string[]
- `direction` 'asc' | 'desc', required
- `start` string, date-time
- `end` string, date-time
- `limit` integer, required
- `order_by` 'start_time' | 'end_time'

## Response `200`

A paginated result set

- object — A paginated result set
  - `data` object[], required
    - `traceId` string, required
    - `name` string, required
    - `startTimeUnixNano` string, required
    - `endTimeUnixNano` string, required — 0 if trace is unfinished
    - `attributes` object[], required
      - `key` string, required
      - `value` object, required
        - `stringValue` string
        - `intValue` string
        - `doubleValue` number
        - `boolValue` boolean
        - `arrayValue` unknown
        - `kvlistValue` unknown
        - `bytesValue` string
    - `status` object, required
      - `message` string, required
      - `code` number, required
  - `links` PaginationLinks, required — Links to use for pagination
    - `self` string, uri, required — URL of this page
    - `prev` string, uri — URL of the previous page, if any
    - `next` string, uri — URL of the next page, if any

---

[API](https://skmtc.net/val-town/apis/val-town-api.md) · [All operations](https://skmtc.net/val-town/apis/val-town-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/val-town/val-town-api/versions/4d8b6d2e6db3/schema)