---
title: "Get project trace analytics"
method: GET
path: "/v1/projects/{projectSlug}/traces/analytics"
tags: ["Traces"]
---

# Get project trace analytics

`GET /v1/projects/{projectSlug}/traces/analytics`

Returns trace analytics for the project: a total (or median) per metric over the requested range, plus a per-bucket series for each metric. Buckets are 12-hour UTC-aligned. The range defaults to the trailing 7 days.

## Path parameters

- `projectSlug` string, required — Project slug (human-readable identifier)

## Query parameters

- `fromIso` string, date-time — Lower bound (inclusive) of the time range. Defaults to 7 days before `toIso`.
- `toIso` string, date-time — Upper bound (inclusive) of the time range. Defaults to now.

## Response `200`

Trace analytics

- TraceAnalyticsResponse
  - `traces` TraceAnalyticsTraces, required
    - `total` number, required — Number of traces in the range.
    - `buckets` TraceAnalyticsBucket[], required — Number of traces per bucket.
      - `bucket` string, required — ISO-8601 UTC timestamp of the bucket's start.
      - `value` number, required — Metric value for this bucket.
  - `cost` TraceAnalyticsCost, required
    - `total` number, required — Total trace cost in USD.
    - `buckets` TraceAnalyticsBucket[], required — Trace cost per bucket in USD.
      - `bucket` string, required — ISO-8601 UTC timestamp of the bucket's start.
      - `value` number, required — Metric value for this bucket.
  - `duration` TraceAnalyticsDuration, required
    - `median` number, required — Median trace duration in seconds.
    - `buckets` TraceAnalyticsBucket[], required — Median trace duration per bucket in seconds.
      - `bucket` string, required — ISO-8601 UTC timestamp of the bucket's start.
      - `value` number, required — Metric value for this bucket.
  - `tokens` TraceAnalyticsTokens, required
    - `total` number, required — Total tokens across all LLM spans.
    - `buckets` TraceAnalyticsBucket[], required — Tokens per bucket across all LLM spans.
      - `bucket` string, required — ISO-8601 UTC timestamp of the bucket's start.
      - `value` number, required — Metric value for this bucket.
  - `timeToFirstToken` TraceAnalyticsTimeToFirstToken, required
    - `median` number, required — Median time-to-first-token across LLM spans, in seconds.
    - `buckets` TraceAnalyticsBucket[], required — Median time-to-first-token per bucket, in seconds.
      - `bucket` string, required — ISO-8601 UTC timestamp of the bucket's start.
      - `value` number, required — Metric value for this bucket.
  - `spans` TraceAnalyticsSpans, required
    - `total` number, required — Total number of spans.
    - `buckets` TraceAnalyticsBucket[], required — Number of spans per bucket.
      - `bucket` string, required — ISO-8601 UTC timestamp of the bucket's start.
      - `value` number, required — Metric value for this bucket.

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/latitude-dev/apis/latitude.md) · [All operations](https://skmtc.net/latitude-dev/apis/latitude/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude-dev/latitude/versions/6a8789c59a5c/schema)