---
title: "List Flow Segments"
method: HEAD
path: "/flows/{flowId}/segments"
tags: ["FlowSegments"]
---

# List Flow Segments

`HEAD /flows/{flowId}/segments`

Return Flow Segments path headers

## Query parameters

- `object_id` string
- `timerange` string — A timerange of timestamps. It is represented using one or two timestamps with inclusivity and exclusivity markers. E.g. * `[0:0_10:0)` represents 10 seconds of media starting at timestamp `0:0` and ending before `10:0`. * `(5:0_` represents a timerange starting after `5:0` and to eternity. * `_` without timestamps or inclusivity markers represents "eternity" (i.e. the entire timeline). * `()` without timestamps represents "never" (i.e. a range of zero length in no particular position). * `[1694429247:0_1694429248:0)` is a 1 second TAI timerange starting at 2023-09-11T10:46:50.0Z UTC. * `[1694429247:0]` is an instantaneous TAI timerange at 2023-09-11T10:46:50.0Z UTC. This is equivalent to `[1694429247:0_1694429247:0]`. The short syntax is preferred due to ease of identification as instantaneous. Instantaneous TimeRanges cannot use exclusive markers (i.e. `(` or `)`). * A `[` or `]` indicates that bound is inclusive, and a `(` or `)` indicates that bound is exclusive. Details of the format can be found in the [Timestamps in TAMS](https://github.com/bbc/tams/blob/main/docs/appnotes/0008-timestamps-in-TAMS.md) application note.
- `reverse_order` boolean
- `verbose_storage` boolean
- `accept_get_urls` string — A list of Object GET URL Labels, formatted for use in query string parameters
- `accept_storage_ids` string — A list of Universally Unique Identifiers (UUIDs) as defined in [RFC9562](https://www.rfc-editor.org/rfc/rfc9562), formatted for use in query string parameters
- `presigned` boolean
- `storage_backend_tag.{name}` string
- `storage_backend_tag_exists.{name}` boolean
- `include_object_timerange` boolean
- `page` string
- `limit` integer

## Response `200`

- string

## Other responses

- `400` — Bad request. Invalid query options.
- `404` — The Flow ID in the path is invalid.

## Changes

- **2026-08-25** `eb3977b33601` — 2 info
  - added the new optional `query` request parameter `storage_backend_tag.{name}`
  - added the new optional `query` request parameter `storage_backend_tag_exists.{name}`
- **2025-10-21** `4c8d2bfcb854` — 1 info
  - added the new optional `query` request parameter `include_object_timerange`
- **2025-07-02** `fff531b4534a` — 3 info
  - added the new optional `query` request parameter `accept_storage_ids`
  - added the new optional `query` request parameter `presigned`
  - added the new optional `query` request parameter `verbose_storage`
- **2025-06-11** `e3d4dd57646b` — 1 warning
  - changed the pattern of the `query` request parameter `timerange` from `^(\[|\()?(-?\d+:\d+)?(_(-?\d+:\d+)?)?(\]|\))?$` to `^(\[|\()?(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?(_(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?)?(\]|\))?$`
- **2025-04-24** `b01aaf8cffe2` — 5 warning
  - changed the pattern of the `query` request parameter `timerange` from `^(\[|\()?(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?(_(-?(0|[1-9][0-9]*):(0|[1-9][0-9]{0,8}))?)?(\]|\))?$` to `^(\[|\()?(-?\d+:\d+)?(_(-?\d+:\d+)?)?(\]|\))?$`
  - deleted the `query` request parameter `accept_storage_ids`
  - deleted the `query` request parameter `include_object_timerange`
  - deleted the `query` request parameter `presigned`
  - …1 more

[Change history](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/flows/:flowId/segments/head.md)

---

[API](https://skmtc.dev/aws-samples/apis/time-addressable-media-store.md) · [All operations](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/time-addressable-media-store/revisions/eb3977b33601/schema)