---
title: "Get the configurable gate evaluation for a trail"
method: GET
path: "/api/v1/trails/{forge}/{owner}/{repo}/{number}/gates"
tags: ["Trails"]
---

# Get the configurable gate evaluation for a trail

`GET /api/v1/trails/{forge}/{owner}/{repo}/{number}/gates`

## Path parameters

- `forge` string, required
- `owner` string, required
- `repo` string, required
- `number` string, required

## Response `200`

Gate evaluation

- object
  - `head_sha` string, nullable, required
  - `gates` object[], required
    - `reviewers` object[]
      - `login` string, required
      - `state` 'pending' | 'approved' | 'stale' | 'changes_requested' | 'excluded', required
      - `reviewed_head_sha` string, nullable, required
      - `reason` string, nullable, required
    - `runner_ids` string[]
    - `state` 'not_run' | 'running' | 'evaluated' | 'stale' | 'disabled' | 'not_applicable' | 'configuration_error'
    - `outcome` 'passed' | 'failed' | 'errored', nullable
    - `evaluated_at_sha` string, nullable
    - `stale_reason` 'head_moved' | 'config_changed', nullable
    - `finding_count` number, nullable
    - `id` string, required
    - `gate_definition_id` string, required
    - `gate_key` string, required
    - `gate_type` 'approvals' | 'findings' | 'checks' | 'up_to_date' | 'base_checks' | 'eval', required
    - `blocking` boolean, required
    - `status` 'passed' | 'failed' | 'pending' | 'error' | 'skipped', required
    - `head_sha` string, nullable, required
    - `value` unknown, required
    - `rationale` string, nullable, required
    - `created_at` string, required
    - `completed_at` string, nullable, required
  - `blocking_failures` object[], required
    - `reviewers` object[]
      - `login` string, required
      - `state` 'pending' | 'approved' | 'stale' | 'changes_requested' | 'excluded', required
      - `reviewed_head_sha` string, nullable, required
      - `reason` string, nullable, required
    - `runner_ids` string[]
    - `state` 'not_run' | 'running' | 'evaluated' | 'stale' | 'disabled' | 'not_applicable' | 'configuration_error'
    - `outcome` 'passed' | 'failed' | 'errored', nullable
    - `evaluated_at_sha` string, nullable
    - `stale_reason` 'head_moved' | 'config_changed', nullable
    - `finding_count` number, nullable
    - `id` string, required
    - `gate_definition_id` string, required
    - `gate_key` string, required
    - `gate_type` 'approvals' | 'findings' | 'checks' | 'up_to_date' | 'base_checks' | 'eval', required
    - `blocking` boolean, required
    - `status` 'passed' | 'failed' | 'pending' | 'error' | 'skipped', required
    - `head_sha` string, nullable, required
    - `value` unknown, required
    - `rationale` string, nullable, required
    - `created_at` string, required
    - `completed_at` string, nullable, required
  - `mergeable` boolean, required
  - `evaluated_at` string, nullable, required

## Other responses

- `404` — Trail not found

## Changes

- **2026-09-24** `ba1409f8f36b` — 2 warning
  - added the new `base_checks` enum value to the `blocking_failures/items/gate_type` response property for the response status `200`
  - added the new `base_checks` enum value to the `gates/items/gate_type` response property for the response status `200`
- **2026-09-17** `e1f0e2f14d0a` — 2 info
  - added the optional property `blocking_failures/items/reviewers` to the response with the `200` status
  - added the optional property `gates/items/reviewers` to the response with the `200` status

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