# ContainerState


[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





Schema constraints and annotations:

```json
{
  "description": "ContainerState stores container's running state. It's part of ContainerJSONBase\nand will be returned by the \"inspect\" command.\n",
  "properties": {
    "Dead": {
      "example": false,
      "type": "boolean"
    },
    "Error": {
      "type": "string"
    },
    "ExitCode": {
      "description": "The last exit code of this container",
      "example": 0,
      "type": "integer"
    },
    "FinishedAt": {
      "description": "The time when this container last exited.",
      "example": "2020-01-06T09:07:59.461876391Z",
      "type": "string"
    },
    "Health": {
      "$ref": "#/components/schemas/Health"
    },
    "OOMKilled": {
      "description": "Whether a process within this container has been killed because it ran\nout of memory since the container was last started.\n",
      "example": false,
      "type": "boolean"
    },
    "Paused": {
      "description": "Whether this container is paused.",
      "example": false,
      "type": "boolean"
    },
    "Pid": {
      "description": "The process ID of this container",
      "example": 1234,
      "type": "integer"
    },
    "Restarting": {
      "description": "Whether this container is restarting.",
      "example": false,
      "type": "boolean"
    },
    "Running": {
      "description": "Whether this container is running.\n\nNote that a running container can be _paused_. The `Running` and `Paused`\nbooleans are not mutually exclusive:\n\nWhen pausing a container (on Linux), the freezer cgroup is used to suspend\nall processes in the container. Freezing the process requires the process to\nbe running. As a result, paused containers are both `Running` _and_ `Paused`.\n\nUse the `Status` field instead to determine if a container's state is \"running\".\n",
      "example": true,
      "type": "boolean"
    },
    "StartedAt": {
      "description": "The time when this container was last started.",
      "example": "2020-01-06T09:06:59.461876391Z",
      "type": "string"
    },
    "Status": {
      "description": "String representation of the container state. Can be one of \"created\",\n\"running\", \"paused\", \"restarting\", \"removing\", \"exited\", or \"dead\".\n",
      "enum": [
        "created",
        "running",
        "paused",
        "restarting",
        "removing",
        "exited",
        "dead"
      ],
      "example": "running",
      "type": "string"
    }
  },
  "type": "object",
  "x-nullable": true
}
```



