---
title: Server information
description: Retrieve server metrics, health status, and version information for InfluxDB 3 Core.
url: https://docs.influxdata.com/influxdb3/core/api/server-information/
estimated_tokens: 894
product: InfluxDB 3 Core
version: core
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/core/api/server-information/
---

[Download InfluxDB 3 Core API Spec](/openapi/influxdb3-core-openapi.yml)

Retrieve server metrics, health status, and version information for InfluxDB 3 Core.

GET`/api/v1/health`

### Health check (v1)

Checks the status of the service.

Returns `OK` if the service is running. This endpoint does not return version information.
Use the [`/ping`](#operation/GetPing) endpoint to retrieve version details.

>
>
> **Note**: This endpoint requires authentication by default in InfluxDB 3 Core.
>
>

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/api/v1/health" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Service is running. Returns `OK`.

401Unauthorized. Authentication is required.

500Service is unavailable.

GET`/health`

### Health check

Checks the status of the service.

Returns `OK` if the service is running. This endpoint does not return version information.
Use the [`/ping`](#operation/GetPing) endpoint to retrieve version details.

>
>
> **Note**: This endpoint requires authentication by default in InfluxDB 3 Core.
>
>

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/health" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Service is running. Returns `OK`.

401Unauthorized. Authentication is required.

500Service is unavailable.

GET`/metrics`

### Metrics

Retrieves Prometheus-compatible server metrics.

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/metrics" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success

GET`/ping`

### Ping the server

Returns version information for the server.

**Important**: Use a GET request. HEAD requests return `404 Not Found`.

The response includes version information in both headers and the JSON body:

* **Headers**: `x-influxdb-version` and `x-influxdb-build`
* **Body**: JSON object with `version`, `revision`, and `process_id`

>
>
> **Note**: This endpoint requires authentication by default in InfluxDB 3 Core.
>
>

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://localhost:8181/ping" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success. The response body contains server information.

`process_id`string

A unique identifier for the server process.

Example:`"b756d9e0-cecd-4f72-b6d0-19e2d4f8cbb7"`

`revision`string

The git revision hash for the build.

Example:`"83b589b883"`

`version`string

The InfluxDB version number.

Example:`"3.8.0"`

401Unauthorized. Authentication is required.

404Not Found. Returned for HEAD requests.
Use a GET request to retrieve version information.

POST`/ping`

### Ping the server

Returns version information for the server. Accepts POST in addition to GET.

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/ping" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Success. The response body contains server information.

`process_id`string

A unique identifier for the server process.

Example:`"b756d9e0-cecd-4f72-b6d0-19e2d4f8cbb7"`

`revision`string

The git revision hash for the build.

Example:`"83b589b883"`

`version`string

The InfluxDB version number.

Example:`"3.8.0"`

401Unauthorized. Authentication is required.

404Not Found. Returned for HEAD requests.
Use a GET request to retrieve version information.

#### Related

* [InfluxDB 3 API client libraries](/influxdb3/core/reference/client-libraries/v3/)