---
title: "List all tracker projects"
method: GET
path: "/tracker-projects"
tags: ["Tracker Projects"]
---

# List all tracker projects

`GET /tracker-projects`

List all tracker projects for the authenticated team.

## Query parameters

- `cursor` string, nullable — Cursor for pagination, representing the last item from the previous page
- `pageSize` number — Number of projects to return per page (1-100)
- `q` string, nullable — Search query string to filter projects by name or description
- `start` string, nullable — Start date for filtering projects by creation date in YYYY-MM-DD format
- `end` string, nullable — End date for filtering projects by creation date in YYYY-MM-DD format
- `status` 'in_progress' | 'completed' | 'null', nullable — Filter projects by status
- `customers` string[], nullable — Array of customer IDs to filter projects by specific customers
- `tags` string[], nullable — Array of tag IDs to filter projects by specific tags
- `sort` string[], nullable — Sort as [column, direction]. Columns: name, created_at, time, amount, assigned, customer, tags. Direction: asc or desc.

## Response `200`

List all tracker projects for the authenticated team.

- TrackerProjectsResponse
  - `meta` object, required — Pagination metadata for the projects response
    - `hasNextPage` boolean, required — Whether there are more projects available on the next page
    - `hasPreviousPage` boolean, required — Whether there are more projects available on the previous page
  - `data` TrackerProjectResponse[], required — Array of tracker projects matching the query criteria
    - `id` string, uuid, required — Unique identifier of the project
    - `name` string, required — Name of the project
    - `description` string, nullable, required — Detailed description of the project
    - `status` 'in_progress' | 'completed', required — Current status of the project
    - `estimate` number, nullable, required — Estimated total hours required to complete the project
    - `currency` string, nullable, required — Currency code for the project rate in ISO 4217 format
    - `createdAt` string, required — Date and time when the project was created in ISO 8601 format
    - `totalDuration` number, nullable, required — Total tracked time for the project in seconds
    - `totalAmount` number, required — Total monetary amount earned from the project
    - `customer` object, nullable, required — Customer information associated with the project
      - `id` string, uuid, required — Unique identifier of the customer
      - `name` string, required — Name of the customer or organization
      - `website` string, required — Website URL of the customer
    - `tags` object[], required — Array of tags associated with the project
      - `id` string, uuid, required — Unique identifier of the tag
      - `name` string, required — Display name of the tag
    - `users` object[], nullable, required — Array of users assigned to work on the project
      - `id` string, uuid, required — Unique identifier of the user
      - `fullName` string, required — Full name of the user
      - `avatarUrl` string, uri, required — URL to the user's avatar image

## Other responses

- `default` — An error occurred

---

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