# Ping


[API catalog](/reference/api/) · [Docker Engine overview](/reference/api/engine/version/v1.57/) · [Product manual](https://docs.docker.com/engine/) · [OpenAPI specification](/reference/api/engine/version/v1.57.yaml)

API version: 1.57





`GET /_ping`

This is a dummy endpoint you can use to test if the server is accessible.

## Connection and access

[API connection and authentication guidance](/reference/api/engine/version/v1.57/#connection)


Server: `/v1.57`

Effective security: alternatives are OR; schemes within an alternative are AND. An empty array declares no HTTP authentication requirement.

```json
null
```

## Example request

Replace placeholders and provide the required credentials or request body.

```console
curl \
  --request GET \
  --unix-socket "${DOCKER_SOCKET:-/var/run/docker.sock}" \
  --header 'Accept: text/plain' \
  'http://localhost/v1.57/_ping'
```



## Parameters

## Request and responses

### Response 200 text/plain

no error


Schema:

```json
{
  "example": "OK",
  "type": "string"
}
```



Headers:

```json
{
  "Api-Version": {
    "description": "Max API Version the server supports",
    "schema": {
      "type": "string"
    }
  },
  "Builder-Version": {
    "description": "Default version of docker image builder\n\nThe default on Linux is version \"2\" (BuildKit), but the daemon\ncan be configured to recommend version \"1\" (classic Builder).\nWindows does not yet support BuildKit for native Windows images,\nand uses \"1\" (classic builder) as a default.\n\nThis value is a recommendation as advertised by the daemon, and\nit is up to the client to choose which builder to use.\n",
    "schema": {
      "default": "2",
      "type": "string"
    }
  },
  "Cache-Control": {
    "schema": {
      "default": "no-cache, no-store, must-revalidate",
      "type": "string"
    }
  },
  "Docker-Experimental": {
    "description": "If the server is running with experimental mode enabled",
    "schema": {
      "type": "boolean"
    }
  },
  "Pragma": {
    "schema": {
      "default": "no-cache",
      "type": "string"
    }
  },
  "Swarm": {
    "description": "Contains information about Swarm status of the daemon,\nand if the daemon is acting as a manager or worker node.\n",
    "schema": {
      "default": "inactive",
      "enum": [
        "inactive",
        "pending",
        "error",
        "locked",
        "active/worker",
        "active/manager"
      ],
      "type": "string"
    }
  }
}
```







Schema example:
```text
OK
```


### Response 500 application/json

server error


Schema:

```json
{
  "$ref": "#/components/schemas/ErrorResponse"
}
```



Headers:

```json
{
  "Cache-Control": {
    "schema": {
      "default": "no-cache, no-store, must-revalidate",
      "type": "string"
    }
  },
  "Pragma": {
    "schema": {
      "default": "no-cache",
      "type": "string"
    }
  }
}
```







Schema example:
```json
{
  "message": "Something went wrong."
}
```


## Complete operation contract

```json
{
  "description": "This is a dummy endpoint you can use to test if the server is accessible.",
  "operationId": "SystemPing",
  "responses": {
    "200": {
      "content": {
        "text/plain": {
          "schema": {
            "example": "OK",
            "type": "string"
          }
        }
      },
      "description": "no error",
      "headers": {
        "Api-Version": {
          "description": "Max API Version the server supports",
          "schema": {
            "type": "string"
          }
        },
        "Builder-Version": {
          "description": "Default version of docker image builder\n\nThe default on Linux is version \"2\" (BuildKit), but the daemon\ncan be configured to recommend version \"1\" (classic Builder).\nWindows does not yet support BuildKit for native Windows images,\nand uses \"1\" (classic builder) as a default.\n\nThis value is a recommendation as advertised by the daemon, and\nit is up to the client to choose which builder to use.\n",
          "schema": {
            "default": "2",
            "type": "string"
          }
        },
        "Cache-Control": {
          "schema": {
            "default": "no-cache, no-store, must-revalidate",
            "type": "string"
          }
        },
        "Docker-Experimental": {
          "description": "If the server is running with experimental mode enabled",
          "schema": {
            "type": "boolean"
          }
        },
        "Pragma": {
          "schema": {
            "default": "no-cache",
            "type": "string"
          }
        },
        "Swarm": {
          "description": "Contains information about Swarm status of the daemon,\nand if the daemon is acting as a manager or worker node.\n",
          "schema": {
            "default": "inactive",
            "enum": [
              "inactive",
              "pending",
              "error",
              "locked",
              "active/worker",
              "active/manager"
            ],
            "type": "string"
          }
        }
      }
    },
    "500": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      },
      "description": "server error",
      "headers": {
        "Cache-Control": {
          "schema": {
            "default": "no-cache, no-store, must-revalidate",
            "type": "string"
          }
        },
        "Pragma": {
          "schema": {
            "default": "no-cache",
            "type": "string"
          }
        }
      }
    }
  },
  "summary": "Ping",
  "tags": [
    "System"
  ]
}
```

## Referenced schemas

- [#/components/schemas/ErrorResponse](/reference/api/engine/version/v1.57/schemas/ErrorResponse/)




