---
title: "List projects filtered by organization ID."
method: GET
path: "/tracer/project/list_projects/"
tags: ["tracer"]
---

# List projects filtered by organization ID.

`GET /tracer/project/list_projects/`

## Request

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

Volume counts come from ClickHouse (fast) instead of a PG
JOIN on observation_spans (was 12+ seconds).

## Query parameters

- `name` string
- `project_type` string
- `tags` string
- `filters` string
- `sort_by` string
- `sort_direction` 'asc' | 'desc'
- `page_number` integer
- `page_size` integer

## Response `200`

OK

- ProjectListResponse
  - `status` boolean
  - `result` ProjectListResult, required
    - `metadata` ProjectListMetadata, required
      - `total_rows` integer, required
      - `page_number` integer, required
      - `page_size` integer, required
      - `total_pages` integer, required
    - `table` ProjectListItem[], required
      - `id` string, uuid, required
      - `name` string, required
      - `last_30_days_vol` integer, nullable, required
      - `daily_volume` integer[], nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `last_active` string, date-time, nullable, required
      - `activity_query_complete` boolean, required
      - `activity_error_code` string, nullable, required
      - `activity_query_exact` boolean, required
      - `activity_query_provenance` string, required
      - `run_count` integer, required
      - `issues` integer, required
      - `tags` string[], required

## Other responses

- `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)