---
title: "Get image information from the registry"
method: GET
path: "/distribution/{name}/json"
tags: ["Distribution"]
---

# Get image information from the registry

`GET /distribution/{name}/json`

Return image digest and platform information by contacting the registry.

## Path parameters

- `name` string, required

## Response `200`

descriptor and platform information

- DistributionInspect — Describes the result obtained from contacting the registry to retrieve image metadata.
  - `Descriptor` OCIDescriptor, required — A descriptor struct containing digest, media type, and size, as defined in the [OCI Content Descriptors Specification](https://github.com/opencontainers/image-spec/blob/v1.0.1/descriptor.md).
    - `mediaType` string — The media type of the object this schema refers to.
    - `digest` string — The digest of the targeted content.
    - `size` integer — The size in bytes of the blob.
  - `Platforms` OCIPlatform[], required — An array containing all platforms supported by the image.
    - `architecture` string — The CPU architecture, for example `amd64` or `ppc64`.
    - `os` string — The operating system, for example `linux` or `windows`.
    - `os.version` string — Optional field specifying the operating system version, for example on Windows `10.0.19041.1165`.
    - `os.features` string[] — Optional field specifying an array of strings, each listing a required OS feature (for example on Windows `win32k`).
    - `variant` string — Optional field specifying a variant of the CPU, for example `v7` to specify ARMv7 when architecture is `arm`.

## Other responses

- `401` — Failed authentication or no image found
- `500` — Server error

---

[API](https://skmtc.net/aliyun/apis/docker-engine-api.md) · [All operations](https://skmtc.net/aliyun/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aliyun/docker-engine-api/revisions/04bb09da9ccb/schema)