---
title: "Get the list of versions for a specific data package."
method: GET
path: "/dataPackages/{dataPackageId}/versions"
tags: ["Data Packages"]
---

# Get the list of versions for a specific data package.

`GET /dataPackages/{dataPackageId}/versions`

## Request

- Base URL: `https://api.os.uk/downloads/v1`
- URL: `https://api.os.uk/downloads/v1/dataPackages/{dataPackageId}/versions`
- 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

## Response `200`

A list of data package versions.

- DataPackageVersionSummary[]
  - `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

## 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)