---
title: "GET /tracer/users/"
method: GET
path: "/tracer/users/"
tags: ["tracer"]
---

# GET /tracer/users/

`GET /tracer/users/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/users/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

List traces filtered by project ID with optimized queries.

## Query parameters

- `project_id` string, uuid
- `search` string
- `page_size` integer
- `current_page_index` integer
- `sort_params` string
- `filters` string
- `export` boolean
- `cursor` string
- `cursor_mode` boolean
- `requested_columns` string
- `attribute_keys` string

## Response `200`

OK

- UsersResponse
  - `status` boolean
  - `result` UsersResult, required
    - `table` UsersTableRow[], required
      - `user_id` string, nullable
      - `total_cost` number, required
      - `total_tokens` integer, nullable
      - `input_tokens` integer, nullable
      - `output_tokens` integer, nullable
      - `num_traces` integer, nullable
      - `num_sessions` integer, nullable
      - `num_sessions_is_approximate` boolean
      - `avg_session_duration` number, nullable
      - `avg_trace_latency` number, nullable
      - `num_llm_calls` integer, nullable
      - `num_guardrails_triggered` integer, nullable
      - `activated_at` string, date-time, nullable
      - `last_active` string, date-time, nullable
      - `num_active_days` integer, nullable
      - `num_traces_with_errors` integer, nullable
      - `bool_eval_pass_rate` number, nullable
      - `avg_output_float` number, nullable
      - `project_id` string, uuid, nullable
      - `project_name` string, nullable
      - `user_id_type` string, nullable
      - `user_id_hash` string, nullable
      - `end_user_id` string, uuid, nullable
    - `total_count` integer, required
    - `total_pages` integer, required
    - `count_is_lower_bound` boolean
    - `has_more` boolean
    - `next_cursor` string, nullable
    - `next_cursor_fingerprint` string, nullable
    - `query_complete` boolean
    - `query_status` 'complete' | 'degraded'
    - `query_exact` boolean
    - `query_provenance` 'span_user_rollup_end_users_candidate' | 'physical_latest_users' | 'matching_activity_walk'
    - `ordering_exact` boolean
    - `ordering` 'latest_matching_activity'
    - `approximate_fields` string[]

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)