---
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: 3401
product: InfluxDB 3 Core
version: core
---

[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

200 Service is running. Returns `OK`.

401 Unauthorized. Authentication is required.

500 Service 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

200 Service is running. Returns `OK`.

401 Unauthorized. Authentication is required.

500 Service 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

200 Success

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

200 Success. 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"`

401 Unauthorized. Authentication is required.

404 Not 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

200 Success. 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"`

401 Unauthorized. Authentication is required.

404 Not 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/)