# tag


[API catalog](/reference/api/) · [Docker Hub overview](/reference/api/hub/latest/) · [Product manual](https://docs.docker.com/docker-hub/) · [OpenAPI specification](/reference/api/hub/latest.yaml)

API version: 2-beta



Schema constraints and annotations:

```json
{
  "examples": [
    {
      "creator": 1234,
      "full_size": 123456,
      "id": 12345,
      "images": [
        {
          "architecture": "amd64",
          "features": null,
          "last_pulled": null,
          "last_pushed": "2021-01-05T21:06:53.506400Z",
          "os": "linux",
          "os_features": null,
          "os_version": null,
          "size": 123456,
          "status": "active",
          "variant": null
        }
      ],
      "last_updated": "2021-01-05T21:06:53.506400Z",
      "last_updater": 1234,
      "last_updater_username": "dockeruser",
      "name": "latest",
      "repository": 5678,
      "tag_last_pulled": null,
      "tag_last_pushed": "2021-01-05T21:06:53.506400Z",
      "tag_status": "active",
      "v2": true
    }
  ],
  "properties": {
    "creator": {
      "description": "ID of the user that pushed the tag",
      "type": "integer"
    },
    "full_size": {
      "description": "compressed size (sum of all layers) of the tagged image",
      "type": "integer"
    },
    "id": {
      "description": "tag ID",
      "type": "integer"
    },
    "images": {
      "items": {
        "$ref": "#/components/schemas/image"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "last_updated": {
      "description": "datetime of last update",
      "example": "2021-01-05T21:06:53.506400Z",
      "type": [
        "string",
        "null"
      ]
    },
    "last_updater": {
      "description": "ID of the last user that updated the tag",
      "type": "integer"
    },
    "last_updater_username": {
      "description": "Hub username of the user that updated the tag",
      "type": "string"
    },
    "name": {
      "description": "name of the tag",
      "type": "string"
    },
    "repository": {
      "description": "repository ID",
      "type": "integer"
    },
    "tag_last_pulled": {
      "description": "datetime of last pull",
      "example": "2021-01-05T21:06:53.506400Z",
      "type": [
        "string",
        "null"
      ]
    },
    "tag_last_pushed": {
      "description": "datetime of last push",
      "example": "2021-01-05T21:06:53.506400Z",
      "type": [
        "string",
        "null"
      ]
    },
    "tag_status": {
      "description": "whether a tag has been pushed to or pulled in the past month",
      "enum": [
        "active",
        "inactive"
      ],
      "type": "string"
    },
    "v2": {
      "description": "Whether the tag uses the Registry V2 format.",
      "type": "boolean"
    }
  },
  "type": "object"
}
```