---
title: "Returns a list of downloads for a specific OpenData product, or redirects to the actual download if requested."
method: GET
path: "/products/{productId}/downloads"
tags: ["OpenData"]
---

# Returns a list of downloads for a specific OpenData product, or redirects to the actual download if requested.

`GET /products/{productId}/downloads`

## Request

- Base URL: `https://api.os.uk/downloads/v1`
- URL: `https://api.os.uk/downloads/v1/products/{productId}/downloads`
- Auth: none declared

## Path parameters

- `productId` string, required

## Query parameters

- `fileName` string
- `format` string
- `subformat` string
- `area` 'GB' | 'HP' | 'HT' | 'HU' | 'HW' | 'HX' | 'HY' | 'HZ' | 'NA' | 'NB' | 'NC' | 'ND' | 'NF' | 'NG' | 'NH' | 'NJ' | 'NK' | 'NL' | 'NM' | 'NN' | 'NO' | 'NR' | 'NS' | 'NT' | 'NU' | 'NW' | 'NX' | 'NY' | 'NZ' | 'OV' | 'SD' | 'SE' | 'TA' | 'SH' | 'SJ' | 'SK' | 'TF' | 'TG' | 'SM' | 'SN' | 'SO' | 'SP' | 'TL' | 'TM' | 'SR' | 'SS' | 'ST' | 'SU' | 'TQ' | 'TR' | 'SV' | 'SW' | 'SX' | 'SY' | 'SZ' | 'TV': This describes the geographical area that a download covers. GB is all of Great Britain, while codes like 'HP' cover National Grid Reference squares.
- `redirect` boolean

## Response `200`

Successful response.

- ProductDownload[]
  - `url` string, uri, required: Getting this URL will return a HTTP redirect to the actual data.
  - `fileName` string, required: The name of the file.
  - `size` integer: The file size, in bytes.
  - `md5` string: A MD5 checksum of the file data. This can be used to verify the integrity of the data once you have downloaded it.
  - `area` 'GB' | 'HP' | 'HT' | 'HU' | 'HW' | 'HX' | 'HY' | 'HZ' | 'NA' | 'NB' | 'NC' | 'ND' | 'NF' | 'NG' | 'NH' | 'NJ' | 'NK' | 'NL' | 'NM' | 'NN' | 'NO' | 'NR' | 'NS' | 'NT' | 'NU' | 'NW' | 'NX' | 'NY' | 'NZ' | 'OV' | 'SD' | 'SE' | 'TA' | 'SH' | 'SJ' | 'SK' | 'TF' | 'TG' | 'SM' | 'SN' | 'SO' | 'SP' | 'TL' | 'TM' | 'SR' | 'SS' | 'ST' | 'SU' | 'TQ' | 'TR' | 'SV' | 'SW' | 'SX' | 'SY' | 'SZ' | 'TV', required: This describes the geographical area that a download covers. GB is all of Great Britain, while codes like 'HP' cover National Grid Reference squares.
  - `format` string, required: This describes the format of the data.
  - `subformat` string: This describes the subformat of the data.

## Other responses

- `307`: Returned when the 'redirect' parameter was supplied, and there was exactly one matching download.
- `404`: The request does not match any known content. The response will contain a human readable message, and may also contain links to help you navigate to other API endpoints.

---

[API](https://skmtc.dev/ordnance-survey/apis/ordnance-survey-download-api.md) - [All operations](https://skmtc.dev/ordnance-survey/apis/ordnance-survey-download-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ordnance-survey/apis/ordnance-survey-download-api/revisions/c2df1360dd0b?raw)