---
title: "A recording's segments"
method: GET
path: "/v1/recordings/{device}/{id}"
tags: ["Flights"]
---

# A recording's segments

`GET /v1/recordings/{device}/{id}`

## Request

- Base URL: `https://api.uxduck.com`
- URL: `https://api.uxduck.com/v1/recordings/{device}/{id}`
- Auth: HTTP bearer

Its init segment (1) and segments in order, each with its capture time and a URL to download it for an hour, and the segments missing. Joined in order they are its MP4.

## Path parameters

- `device` string, required
- `id` string, required

## Response `200`

The segments and the gaps

- object
  - `segments` object[], required
    - `seq` number, required
    - `size` number, required
    - `sha256` string, required
    - `firstUs` number, nullable, required
    - `lastUs` number, nullable, required
    - `url` string, required
  - `gaps` object[], required
    - `fromSeq` number, required
    - `toSeq` number, required
    - `fromUs` number, nullable, required
    - `toUs` number, nullable, required

## Other responses

- `401`: Not signed in
- `404`: Not one of the account's recordings
- `503`: Accounts are not set up here

---

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