v1

latestOpenAPI 3.1.0AGPL-3.0 license2026-07-1210336283.6 KB
Tracker Projects

List all tracker projects

List all tracker projects for the authenticated team.

get/tracker-projects

Query parameters

cursorstring nullable

Cursor for pagination, representing the last item from the previous page

Example:eyJpZCI6IjEyMyJ9

Cursor for pagination, representing the last item from the previous page

pageSizenumber

Number of projects to return per page (1-100)

Example:20

Number of projects to return per page (1-100)

qstring nullable

Search query string to filter projects by name or description

Example:website

Search query string to filter projects by name or description

startstring nullable

Start date for filtering projects by creation date in YYYY-MM-DD format

Example:2024-04-01

Start date for filtering projects by creation date in YYYY-MM-DD format

endstring nullable

End date for filtering projects by creation date in YYYY-MM-DD format

Example:2024-04-30

End date for filtering projects by creation date in YYYY-MM-DD format

status'in_progress' | 'completed' | 'null' nullable

Filter projects by status

Example:in_progress

Filter projects by status

customersstring[] nullable

Array of customer IDs to filter projects by specific customers

Array of customer IDs to filter projects by specific customers

[
  "customer-1",
  "customer-2"
]
tagsstring[] nullable

Array of tag IDs to filter projects by specific tags

Array of tag IDs to filter projects by specific tags

[
  "tag-1",
  "tag-2"
]
sortstring[] nullable

Sort as [column, direction]. Columns: name, created_at, time, amount, assigned, customer, tags. Direction: asc or desc.

Sort as [column, direction]. Columns: name, created_at, time, amount, assigned, customer, tags. Direction: asc or desc.

[
  "created_at",
  "desc"
]

Response

List all tracker projects for the authenticated team.

Example response

{
  "meta": {
    "hasNextPage": true
  },
  "data": [
    {
      "id": "b7e6c8e2-1f2a-4c3b-9e2d-1a2b3c4d5e6f",
      "name": "Website Redesign",
      "description": "Complete redesign of the company website with modern UI/UX and improved performance",
      "status": "in_progress",
      "estimate": 120,
      "currency": "USD",
      "createdAt": "2024-05-01T12:00:00.000Z",
      "totalDuration": 43200,
      "totalAmount": 3600,
      "customer": {
        "id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
        "name": "Acme Corporation",
        "website": "https://acme.com"
      },
      "tags": [
        {
          "id": "d1e2f3a4-b5c6-7890-abcd-1234567890ef",
          "name": "Design"
        }
      ],
      "users": [
        {
          "id": "f1e2d3c4-b5a6-7890-abcd-1234567890ef",
          "fullName": "Jane Doe",
          "avatarUrl": "https://cdn.midday.ai/avatar.jpg"
        }
      ]
    }
  ]
}