---
title: "GET /images/{image_id}/downloads"
method: GET
path: "/images/{image_id}/downloads"
tags: ["image"]
---

# GET /images/{image_id}/downloads

`GET /images/{image_id}/downloads`

## Path parameters

- `image_id` string, required

## Response `200`

Successfully got download variants.

- ImageDownloads — A list of image download variants
  - `count` integer — The number of image downloads returned
  - `items` ImageDownload[]
    - `id` string, required — the variant
    - `height` integer — Image height, in number of pixels
    - `href` string — Full URL pointing to the image in download service
    - `palette` string — Colour palette of the variant
    - `private` string — S3 Private bucket name
    - `public` boolean — Determines if this image variant is public (i.e. it can be accessed under static.ons.gov.uk)
    - `size` integer — File size in number of bytes
    - `type` string — Type of download corresponding to this variant
    - `width` integer — Image width, in number of pixels
    - `links` object
      - `self` string
      - `image` string
    - `state` 'pending' | 'importing' | 'imported' | 'published' | 'completed' | 'failed-import' | 'failed-publish', required — The state of this download variant. The high level image will change its state to imported only when all variants are in imported state.
    - `error` string — Any error information, if there was an error with this image variant
    - `import_started` string, required — Timestamp representation for the importing process start, formatted according to RFC3339
    - `import_completed` string — Timestamp representation for the importing process completion, formatted according to RFC3339
    - `publish_started` string — Timestamp representation for the publishing process start, formatted according to RFC3339
    - `publish_completed` string — Timestamp representation for the publishing process completion, formatted according to RFC3339
  - `limit` integer — The number of image downloads requested
  - `offset` integer — The first row of image downloads to retrieve, starting at 0. Use this parameter as a pagination mechanism along with the limit parameter
  - `total_count` integer — The total number of image downloads

## Other responses

- `401` — User or service is not authenticated
- `403` — Unauthorised to view images metadata
- `404` — Requested item cannot be found
- `500` — Failed to process the request due to an internal error

---

[API](https://skmtc.net/office-of-national-statistics/apis/image-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/image-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/image-api/revisions/0d1060eb31c2/schema)