---
title: "Get the instance's current egress self-check status"
method: GET
path: "/egress"
tags: ["egress"]
---

# Get the instance's current egress self-check status

`GET /egress`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/egress`
- Auth: HTTP bearer

## Response `200`

OK

- object
  - `success` true, required
  - `msg` string, required
  - `data` EgressSummary, required
    - `enabled` boolean, required
    - `status` 'ok' | 'degraded', required
    - `degradedSince` string, nullable, required
    - `degradedWorkers` number, required
    - `totalWorkers` number, required

## Other responses

- `401`: Unauthorized
- `429`: Too many requests
- `500`: Internal server error

## Changes

- **2026-10-21** `d032378edb69`: 2 info
  - added the required property `data/degradedWorkers` to the response with the `200` status
  - added the required property `data/totalWorkers` to the response with the `200` status
- **2026-10-19** `99900a373fa7`: 1 info
  - added the required property `data/enabled` to the response with the `200` status
- **2026-10-19** `c98f25d171ae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/egress/get.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) - [All operations](https://skmtc.dev/bluewave-labs/apis/checkmate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluewave-labs/apis/checkmate-api/revisions/4f4b0d97c1f9?raw)