@@ -23,7 +23,7 @@ type Backend interface {

 type imageBackend interface {

 	ImageDelete(ctx context.Context, imageRef string, force, prune bool) ([]image.DeleteResponse, error)

-	ImageHistory(ctx context.Context, imageName string) ([]*image.HistoryResponseItem, error)

+	ImageHistory(ctx context.Context, imageName string, platform *ocispec.Platform) ([]*image.HistoryResponseItem, error)

 	Images(ctx context.Context, opts image.ListOptions) ([]*image.Summary, error)

 	GetImage(ctx context.Context, refOrID string, options backend.GetImageOpts) (*dockerimage.Image, error)

 	ImageInspect(ctx context.Context, refOrID string, options backend.ImageInspectOpts) (*image.InspectResponse, error)

@@ -398,7 +398,21 @@ func (ir *imageRouter) getImagesJSON(ctx context.Context, w http.ResponseWriter,

 }

 func (ir *imageRouter) getImagesHistory(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {

-	history, err := ir.backend.ImageHistory(ctx, vars["name"])

+	if err := httputils.ParseForm(r); err != nil {

+		return err

+	}

+

+	var platform *ocispec.Platform

+	if versions.GreaterThanOrEqualTo(httputils.VersionFromContext(ctx), "1.48") {

+		if formPlatform := r.Form.Get("platform"); formPlatform != "" {

+			p, err := httputils.DecodePlatform(formPlatform)

+			if err != nil {

+				return err

+			}

+			platform = p

+		}

+	}

+	history, err := ir.backend.ImageHistory(ctx, vars["name"], platform)

 	if err != nil {

 		return err

 	}

@@ -9202,6 +9202,15 @@ paths:

           description: "Image name or ID"

           type: "string"

           required: true

+        - name: "platform"

+          type: "string"

+          in: "query"

+          description: |

+            JSON encoded OCI platform describing platform to show the history for.

+            If not provided, the host platform will be used. If it's not

+            available, any present platform will be picked.

+

+            Example: `{"os": "linux", "architecture": "arm", "variant": "v5"}`

       tags: ["Image"]

   /images/{name}/push:

     post:

@@ -86,3 +86,9 @@ type RemoveOptions struct {

 	Force         bool

 	PruneChildren bool

 }

+

+// HistoryOptions holds parameters to get image history.

+type HistoryOptions struct {

+	// Platform from the manifest list to use for history.

+	Platform *ocispec.Platform

+}

@@ -3,15 +3,29 @@ package client // import "github.com/docker/docker/client"

 import (

 	"context"

 	"encoding/json"

+	"fmt"

 	"net/url"

 	"github.com/docker/docker/api/types/image"

 )

 // ImageHistory returns the changes in an image in history format.

-func (cli *Client) ImageHistory(ctx context.Context, imageID string) ([]image.HistoryResponseItem, error) {

+func (cli *Client) ImageHistory(ctx context.Context, imageID string, opts image.HistoryOptions) ([]image.HistoryResponseItem, error) {

+	values := url.Values{}

+	if opts.Platform != nil {

+		if err := cli.NewVersionError(ctx, "1.48", "platform"); err != nil {

+			return nil, err

+		}

+

+		p, err := json.Marshal(*opts.Platform)

+		if err != nil {

+			return nil, fmt.Errorf("invalid platform: %v", err)

+		}

+		values.Set("platform", string(p))

+	}

+

 	var history []image.HistoryResponseItem

-	serverResp, err := cli.get(ctx, "/images/"+imageID+"/history", url.Values{}, nil)

+	serverResp, err := cli.get(ctx, "/images/"+imageID+"/history", values, nil)

 	defer ensureReaderClosed(serverResp)

 	if err != nil {

 		return history, err

@@ -20,7 +20,7 @@ func TestImageHistoryError(t *testing.T) {

 	client := &Client{

 		client: newMockClient(errorMock(http.StatusInternalServerError, "Server error")),

 	}

-	_, err := client.ImageHistory(context.Background(), "nothing")

+	_, err := client.ImageHistory(context.Background(), "nothing", image.HistoryOptions{})

 	assert.Check(t, is.ErrorType(err, errdefs.IsSystem))

 }

@@ -51,7 +51,7 @@ func TestImageHistory(t *testing.T) {

 			}, nil

 		}),

 	}

-	imageHistories, err := client.ImageHistory(context.Background(), "image_id")

+	imageHistories, err := client.ImageHistory(context.Background(), "image_id", image.HistoryOptions{})

 	if err != nil {

 		t.Fatal(err)

 	}

@@ -91,7 +91,7 @@ type ImageAPIClient interface {

 	BuildCachePrune(ctx context.Context, opts types.BuildCachePruneOptions) (*types.BuildCachePruneReport, error)

 	BuildCancel(ctx context.Context, id string) error

 	ImageCreate(ctx context.Context, parentReference string, options image.CreateOptions) (io.ReadCloser, error)

-	ImageHistory(ctx context.Context, image string) ([]image.HistoryResponseItem, error)

+	ImageHistory(ctx context.Context, image string, opts image.HistoryOptions) ([]image.HistoryResponseItem, error)

 	ImageImport(ctx context.Context, source image.ImportSource, ref string, options image.ImportOptions) (io.ReadCloser, error)

 	ImageInspectWithRaw(ctx context.Context, image string) (image.InspectResponse, []byte, error)

 	ImageList(ctx context.Context, options image.ListOptions) ([]image.Summary, error)

@@ -18,15 +18,14 @@ import (

 // ImageHistory returns a slice of HistoryResponseItem structures for the

 // specified image name by walking the image lineage.

-func (i *ImageService) ImageHistory(ctx context.Context, name string) ([]*imagetype.HistoryResponseItem, error) {

+func (i *ImageService) ImageHistory(ctx context.Context, name string, platform *ocispec.Platform) ([]*imagetype.HistoryResponseItem, error) {

 	start := time.Now()

 	img, err := i.resolveImage(ctx, name)

 	if err != nil {

 		return nil, err

 	}

-	// TODO: pass platform in from the CLI

-	pm := matchAllWithPreference(platforms.Default())

+	pm := i.matchRequestedOrDefault(platforms.Only, platform)

 	im, err := i.getBestPresentImageManifest(ctx, img, pm)

 	if err != nil {

@@ -40,7 +40,7 @@ type ImageService interface {

 	ImportImage(ctx context.Context, ref reference.Named, platform *ocispec.Platform, msg string, layerReader io.Reader, changes []string) (image.ID, error)

 	TagImage(ctx context.Context, imageID image.ID, newTag reference.Named) error

 	GetImage(ctx context.Context, refOrID string, options backend.GetImageOpts) (*image.Image, error)

-	ImageHistory(ctx context.Context, name string) ([]*imagetype.HistoryResponseItem, error)

+	ImageHistory(ctx context.Context, name string, platform *ocispec.Platform) ([]*imagetype.HistoryResponseItem, error)

 	CommitImage(ctx context.Context, c backend.CommitConfig) (image.ID, error)

 	SquashImage(id, parent string) (string, error)

 	ImageInspect(ctx context.Context, refOrID string, opts backend.ImageInspectOpts) (*imagetype.InspectResponse, error)

@@ -9,13 +9,14 @@ import (

 	"github.com/docker/docker/api/types/backend"

 	"github.com/docker/docker/api/types/image"

 	"github.com/docker/docker/layer"

+	ocispec "github.com/opencontainers/image-spec/specs-go/v1"

 )

 // ImageHistory returns a slice of ImageHistory structures for the specified image

 // name by walking the image lineage.

-func (i *ImageService) ImageHistory(ctx context.Context, name string) ([]*image.HistoryResponseItem, error) {

+func (i *ImageService) ImageHistory(ctx context.Context, name string, platform *ocispec.Platform) ([]*image.HistoryResponseItem, error) {

 	start := time.Now()

-	img, err := i.GetImage(ctx, name, backend.GetImageOpts{})

+	img, err := i.GetImage(ctx, name, backend.GetImageOpts{Platform: platform})

 	if err != nil {

 		return nil, err

 	}

@@ -17,6 +17,10 @@ keywords: "API, Docker, rcli, REST, documentation"

 [Docker Engine API v1.48](https://docs.docker.com/engine/api/v1.48/) documentation

+* `GET /images/{name}/history` now supports a `platform` parameter (JSON

+  encoded OCI Platform type) that allows to specify a platform to show the

+  history of.

+

 ## v1.47 API changes

 [Docker Engine API v1.47](https://docs.docker.com/engine/api/v1.47/) documentation

@@ -73,7 +73,7 @@ func (s *DockerAPISuite) TestAPIImagesHistory(c *testing.T) {

 	buildImageSuccessfully(c, name, build.WithDockerfile("FROM busybox\nENV FOO bar"))

 	id := getIDByName(c, name)

-	historydata, err := apiClient.ImageHistory(testutil.GetContext(c), id)

+	historydata, err := apiClient.ImageHistory(testutil.GetContext(c), id, image.HistoryOptions{})

 	assert.NilError(c, err)

 	assert.Assert(c, len(historydata) != 0)

@@ -8,6 +8,7 @@ import (

 	"github.com/docker/docker/api/types"

 	containertypes "github.com/docker/docker/api/types/container"

+	"github.com/docker/docker/api/types/image"

 	dclient "github.com/docker/docker/client"

 	"github.com/docker/docker/integration/internal/container"

 	"github.com/docker/docker/pkg/stdcopy"

@@ -105,9 +106,9 @@ func TestBuildSquashParent(t *testing.T) {

 		container.WithCmd("/bin/sh", "-c", `[ "$(echo $HELLO)" = "world" ]`),

 	)

-	origHistory, err := client.ImageHistory(ctx, origID)

+	origHistory, err := client.ImageHistory(ctx, origID, image.HistoryOptions{})

 	assert.NilError(t, err)

-	testHistory, err := client.ImageHistory(ctx, name)

+	testHistory, err := client.ImageHistory(ctx, name, image.HistoryOptions{})

 	assert.NilError(t, err)

 	inspect, _, err = client.ImageInspectWithRaw(ctx, name)