---
title: "Whether the project's runner is accepting runs"
method: GET
path: "/api/v1/{forge}/{project}/runner-status"
tags: ["Project Agents"]
---

# Whether the project's runner is accepting runs

`GET /api/v1/{forge}/{project}/runner-status`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/{forge}/{project}/runner-status`
- Auth: none declared

The project's version of a repository's runner admission: why runs are stopped, if they are. It needs project read access, not billing access.

## Path parameters

- `forge` 'gh' | 'et', required
- `project` string, required

## Response `200`

Runner admission

- object
  - `runs_paused` boolean, required
  - `paused_by` string, nullable, required: "billing" or "operator"; more may be added
  - `billing_subject` object, nullable, required
    - `type` 'org' | 'account', required
    - `id` string, required

## Other responses

- `400`: Invalid request
- `401`: Not authenticated
- `403`: Feature disabled, or repository push is missing
- `404`: Project or resource not found
- `422`: Validation failed
- `502`: Agents service unavailable

## Changes

- **2026-10-24** `9f678123d588`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/:forge/:project/runner-status/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/a24dfcc828d7?raw)
