---
title: "Download a collection instrument"
method: GET
path: "/collection-instrument-api/1.0.2/download/{instrument_id}"
tags: ["collection-instrument"]
---

# Download a collection instrument

`GET /collection-instrument-api/1.0.2/download/{instrument_id}`

## Request

- Base URL: `https://localhost:8002`
- URL: `https://localhost:8002/collection-instrument-api/1.0.2/download/{instrument_id}`
- Auth: HTTP basic

## Path parameters

- `instrument_id` string, uuid, required

## Response `200`

Successfully downloaded collection instrument

## Other responses

- `404`: Collection instrument not found
- `500`: An external service returned a HTTPError
- `503`: An external service returned a connection error
- `504`: An external service timed out

## Changes

- **2023-02-27** `a428925d8ba4`: 3 info
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`
  - added the non-success response with the status `504`

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/collection-instrument/changes/collection-instrument-api/1.0.2/download/:instrument_id/get.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/collection-instrument.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/collection-instrument/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/collection-instrument/revisions/8897fbcfad31?raw)