---
title: "Download a given recording section"
method: GET
path: "/recording/{recording_id}/download/"
tags: ["recording"]
---

# Download a given recording section

`GET /recording/{recording_id}/download/`

## Request

- Base URL: `https://api.angelcam.com/v1`
- URL: `https://api.angelcam.com/v1/recording/{recording_id}/download/`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://my.angelcam.com/oauth/authorize/`, token URL `https://my.angelcam.com/oauth/token/`
    - Password, token URL `https://api.angelcam.com/oauth/token/`
    - Scopes: `recording_access`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/angelcam/apis/angelcam-api/docs/recording/:recording_id/download/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint will construct a download URL for a specified recording section of a given camera. If there are no records within the section, the download URL will be still returned, however, the URL will respond with HTTP 404. If there are any gaps within the specified recording section, they will be skipped.

Please keep in mind that the maximum downloadable length is 3 hours.

## Path parameters

- `recording_id` string, uuid, required

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required
- `filename` string

## Response `200`

OK

- RecordingDownloadResponse
  - `url` string, url: Download URL

## Other responses

- `400`: Query params are invalid.
- `401`: Missing or invalid authorization.
- `403`: Missing permission.
- `404`: The specified resource was not found

---

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