GET /status/v1/simple

Returns a cumulative status reflecting all services the status service knows about.

Request format

When Forming status API requests to this endpoint, the content type for this endpoint is text/plain; charset=utf-8.

This endpoint supports no parameters. It uses the critical status level by default.

Response format

The server uses these response codes:

  • 200 if, and only if, all services report a status of running.
  • 503 if any service’s status is unknown or error.

The response reflects a single, cumulative status of all services the endpoint is aware of. The endpoint uses this logic to determine which status to report:

  • running if, and only if, all services report as running.
  • error if any one service reports an error.
  • unknown if any one service reports as unknown and no services report an error.

Therefore, while some services may be running, the status can still be error or unknown as long as any one service is not running. For example, if two services report as running and one service reports unknown, then the response is 503: unknown. If one service reports as running, one service reports unknown, and one service reports error, then the endpoint response is 503: error.