---
title: "Get a specific data package version, including details of the files that are available to download."
method: GET
path: "/dataPackages/{dataPackageId}/versions/{versionId}"
tags: ["Data Packages"]
---

# Get a specific data package version, including details of the files that are available to download.

`GET /dataPackages/{dataPackageId}/versions/{versionId}`

## Request

- Base URL: `https://api.os.uk/downloads/v1`
- URL: `https://api.os.uk/downloads/v1/dataPackages/{dataPackageId}/versions/{versionId}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.os.uk/oauth2/token/v1`
  - API key in query parameter `key`
  - API key in header `key`

## Path parameters

- `dataPackageId` string, required
- `versionId` string, required

## Response `200`

A data package version, including download details.

- DataPackageVersion: Summary information about a data package version.
  - `id` string, required
  - `url` string, uri, required
  - `createdOn` string, date, required
  - `reason` 'INITIAL' | 'UPDATE' | 'EXPANSION' | 'RESUPPLY' | 'ONLINE_ORDER', required
  - `supplyType` 'FULL' | 'COU', required
  - `productVersion` string, required
  - `format` string
  - `dataPackageUrl` string, uri
  - `nextVersionUrl` string, uri: Only populated if there is a newer version of the data package.
  - `previousVersionUrl` string, uri: Only populated if there is an older version of the data package.
  - `downloads` Download[], required
    - `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.

## Other responses

- `401`: The API key or OAuth 2 access token is missing or invalid.
- `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)