---
title: "GET /api/status"
method: GET
path: "/api/status"
---

# GET /api/status

`GET /api/status`

Return the fleet-server status.
The status code will either be 200 if healthy, or 503 if not.
Authentication for this endpoint is optional, if not provided a shorter response body is returned.

## Headers

- `X-Request-Id` string
- `Elastic-Api-Version` string

## Response `200`

Healthy fleet-server response.

- StatusResponse — Status response information.
  - `name` string, required — Service name.
  - `status` 'starting' | 'configuring' | 'healthy' | 'degraded' | 'failed' | 'stopping' | 'stopped' | 'unknown', required — A Unit state that fleet-server may report. Unit state is defined in the elastic-agent-client specification.
  - `version` StatusResponseVersion — Version information included in the response to an authorized status request.
    - `number` string — The fleet-server version.
    - `build_hash` string — The commit that the fleet-server was built from.
    - `build_time` string — The date-time that the fleet-server binary was created.

## Other responses

- `400` — A 400 response for receiving an invalid User-Agent, Elastic-Api-Version header or version number (checkin and enroll endpoints). In the case where an invalid or unsupported Elastic-Api-Version header is requested, the response will contain the default version number. Or any other undefined error encounted by the fleet-server. May be returned by any endpoint except /api/fleet/status.
- `503` — Unhealthy fleet-server response.

---

[API](https://skmtc.net/elastic/apis/fleet-server-api.md) · [All operations](https://skmtc.net/elastic/apis/fleet-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/fleet-server-api/versions/e1c8da877dd8/schema)
