This is a cache of https://fess.codelibs.org/15.3/api/api-health.html. It is a snapshot of the page at 2025-11-07T00:14:20.865+0000.
Health API

Menu

Health API

Fetching Status

Request

HTTP Method GET
Endpoint /api/v1/health

By sending a request to Fess at http://<Server Name>/api/v1/health, you can receive the server status of Fess in JSON format.

Request Parameters

There are no request parameters that can be specified.

Response

The following response is returned:

{
  "data": {
    "status": "green",
    "timed_out": false
  }
}

Each element is as follows:

Response Information
data Parent element of search results.
status System status. Returns green when normal, yellow when there are warnings, and red when there are errors.
timed_out Whether a timeout occurred. Returns false if a response is returned within the specified time, true if it times out.

Error Response

When the Health API fails, the following error response is returned:

Error Response
Status Code Description
500 Internal Server Error When an internal server error occurs