---
title: "List Trails across accessible projects"
method: GET
path: "/api/v1/trails"
tags: ["Project Trails"]
---

# List Trails across accessible projects

`GET /api/v1/trails`

## Query parameters

- `status` string[]
- `statusNot` string[]
- `phase` string[]
- `phaseNot` string[]
- `type` string[]
- `typeNot` string[]
- `priority` string[]
- `priorityNot` string[]
- `author` string[]
- `authorNot` string[]
- `assignee` string[]
- `assigneeNot` string[]
- `project` string[]
- `projectNot` string[]
- `projectId` string[]
- `projectIdNot` string[]
- `forge` string[]
- `forgeNot` string[]
- `repoId` string
- `search` string
- `sort` 'updated' | 'title' | 'status' | 'type' | 'priority' | 'assignee'
- `groupBy` 'none' | 'project' | 'status' | 'author' | 'assignee'
- `pageSize` integer
- `pageToken` string

## Response `200`

Trails

- object
  - `items` object[], required
    - `project` object, required
      - `id` string, required
      - `name` string, required
      - `provider` 'github' | 'entire', required
      - `reference` object, required
        - `forge` 'gh' | 'et', required
        - `project` string, required
      - `jurisdiction` string, required
      - `capabilities` object, required
        - `canManageTrails` boolean, required
    - `order` object, required
      - `groupRank` integer, required
      - `groupKey` string, required
      - `sortRank` integer, required
      - `sortValue` string, required
      - `updatedAt` string, required
      - `trailId` string, required
    - `continuationToken` string, required
    - `author` object
      - `accountId` string
      - `login` string, required
      - `displayName` string, required
      - `avatarUrl` string
      - `identity` object, nullable
        - `kind` string, required
        - `accountId` string, nullable, required
        - `displayName` string, nullable, required
        - `avatarUrl` string, nullable, required
        - `handles` object[], required
          - `provider` string, required
          - `handle` string, required
          - `isPrimary` boolean
    - `assigneeProfiles` object[]
      - `accountId` string
      - `login` string, required
      - `displayName` string, required
      - `avatarUrl` string
      - `identity` object, nullable
        - `kind` string, required
        - `accountId` string, nullable, required
        - `displayName` string, nullable, required
        - `avatarUrl` string, nullable, required
        - `handles` object[], required
          - `provider` string, required
          - `handle` string, required
          - `isPrimary` boolean
    - `id` string, required
    - `projectId` string, required
    - `number` integer, required
    - `title` string, required
    - `body` string, required
    - `status` 'draft' | 'open' | 'closed', required
    - `phase` 'planning' | 'building' | 'complete' | 'closed', required
    - `metadata` object, required
    - `type` 'bug' | 'feature' | 'task', required
    - `priority` 'urgent' | 'high' | 'medium' | 'low' | 'none', required
    - `assignees` string[], required
    - `assigneeAccountIds` string[], required
    - `repoIds` string[], required
    - `authorAccountId` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `closedAt` string, nullable, required
    - `changes` object[]
      - `id` string, required
      - `repositoryId` string, required
      - `repository` string, required
      - `branch` string, required
      - `number` integer, required
      - `title` string, required
      - `status` string, required
      - `hasCodeChanges` boolean, required
      - `createdAt` string, required
      - `updatedAt` string, required
    - `isPossiblyPartial` boolean
  - `nextPageToken` string, nullable, required
  - `groupBy` string, required
  - `groups` object[], required
    - `rank` integer, required
    - `key` string, required
    - `label` string, required
    - `totalCount` integer, required
    - `itemCount` integer, required
  - `groupTotals` object[], required
    - `rank` integer, required
    - `key` string, required
    - `label` string, required
    - `totalCount` integer, required

## Changes

- **2026-09-24** `ba1409f8f36b` — 2 info
  - added the optional property `items/items/assigneeProfiles/items/identity` to the response with the `200` status
  - added the optional property `items/items/author/identity` to the response with the `200` status
- **2026-09-21** `03a8a4babd7d` — 3 info
  - added the new optional `query` request parameter `phase`
  - added the new optional `query` request parameter `phaseNot`
  - added the required property `items/items/phase` to the response with the `200` status
- **2026-09-17** `e1f0e2f14d0a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/trails/get.md)

---

[API](https://skmtc.dev/entire/apis/entire-api.md) · [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) · [OpenAPI document](https://skmtc.dev/entire/apis/entire-api/revisions/d69a682d6e44?raw)