---
title: "List groups"
method: GET
path: "/api/v1/tracing/{project_id}/groups"
tags: ["Querying"]
---

# List groups

`GET /api/v1/tracing/{project_id}/groups`

List span groups (public API). Stable API for listing aggregated span groups. Supports basic search and duration filtering. For advanced aggregation with UQL queries (GROUP BY, HAVING, aggregate functions), use list_span_groups instead. Documentation: https://uptrace.dev/features/querying/spans

## Path parameters

- `project_id` integer, required

## Query parameters

- `time_start` string, date-time, required — RFC3339 timestamp.
- `time_end` string, date-time, required — RFC3339 timestamp.
- `query` string
- `limit` integer
- `search` string
- `duration_gte` integer
- `duration_lt` integer

## Response `200`

Aggregated spans.

- object
  - `groups` object[], required — Array of group rows with dynamic columns based on the query.
  - `hasMore` boolean — Whether more results exist beyond the limit.

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.net/uptrace/apis/uptrace-json-api.md) · [All operations](https://skmtc.net/uptrace/apis/uptrace-json-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uptrace/uptrace-json-api/versions/550c8881ab9a/schema)