---
title: "List Flows"
method: HEAD
path: "/flows"
tags: ["Flows"]
---

# List Flows

`HEAD /flows`

Return flows path headers

## Query parameters

- `source_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. * `[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.
- `format` 'urn:x-nmos:format:video' | 'urn:x-nmos:format:audio' | 'urn:x-nmos:format:data' | 'urn:x-nmos:format:multi' — Identifies the content format for a flow or source using a URN string.
- `codec` string — MIME Type string.
- `label` string
- `tag.{name}` string
- `tag_exists.{name}` boolean
- `frame_width` integer
- `frame_height` integer
- `page` string
- `limit` integer

## Response `200`

- string

## Other responses

- `400` — Bad request. Invalid query options.

## Changes

- **2025-04-24** `b01aaf8cffe2` — 1 breaking, 3 warning, 2 info
  - removed the enum value `urn:x-tam:format:image` from the `query` request parameter `format`
  - changed the pattern of the `query` request parameter `codec` from `^(application|audio|font|example|image|message|model|multipart|text|video|x-(?:[0-9A-Za-z!#$%&'*+.^_`|~-]+))/([0-9A-Za-z!#$%&'*+.^_`|~-]+)$` to `.*/.*`
  - 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 `init_segments`
  - …2 more

[Change history](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/flows/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/b01aaf8cffe2/schema)