---
title: "Get Trail filter choices"
method: GET
path: "/api/v1/trails/facets"
tags: ["Project Trails"]
---

# Get Trail filter choices

`GET /api/v1/trails/facets`

## 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

## Response `200`

Trails

- object
  - `facets` object, required
    - `author` object
      - `buckets` object[], required
        - `value` string, required — Core account ID accepted by the author filter.
        - `label` string, required — Core display name, falling back to GitHub login or filter value.
        - `count` integer, required
        - `accountId` string
        - `login` string
        - `avatarUrl` string
    - `assignee` object
      - `buckets` object[], required
        - `value` string, required — Stored Core account ID when known; otherwise the stored login. Pass unchanged as an assignee filter.
        - `label` string, required — Core display name, falling back to GitHub login or filter value.
        - `count` integer, required
        - `accountId` string
        - `login` string
        - `avatarUrl` string

## Changes

- **2026-09-21** `03a8a4babd7d` — 2 info
  - added the new optional `query` request parameter `phase`
  - added the new optional `query` request parameter `phaseNot`
- **2026-09-17** `e1f0e2f14d0a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/trails/facets/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)