---
title: "List Sources"
method: GET
path: "/sources"
tags: ["Sources"]
---

# List Sources

`GET /sources`

List the Sources registered in the TAMS service instance and their details.

## Query parameters

- `label` string
- `reverse_order` boolean
- `sort_by` 'created' | 'updated' | 'label'
- `tag.{name}` string — A list of tag values, formatted for use in query string parameters
- `tag_exists.{name}` boolean
- `format` 'urn:x-nmos:format:video' | 'urn:x-tam:format:image' | 'urn:x-nmos:format:audio' | 'urn:x-nmos:format:data' | 'urn:x-nmos:format:multi', uri — Identifies the content format for a Flow or Source using a URN string
- `collected_by_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, or an empty string. An empty value selects resources that are not in any collection.
- `page` string
- `limit` integer

## Response `200`

- Source[]
  - `id` string, required — A Universally Unique Identifier (UUID) as defined in [RFC9562](https://www.rfc-editor.org/rfc/rfc9562)
  - `format` 'urn:x-nmos:format:video' | 'urn:x-tam:format:image' | 'urn:x-nmos:format:audio' | 'urn:x-nmos:format:data' | 'urn:x-nmos:format:multi', uri, required — Identifies the content format for a Flow or Source using a URN string
  - `label` string — Freeform string label for the Source. This should be a very short, human-readable label that may be displayed in listings of Sources.
  - `description` string — Freeform text describing the Source. This should be a human-readable description that may be showed in detailed views of Sources. The description should be longer and more detailed than `label`.
  - `created_by` string — A string identifier for the entity that created the Source. Service implementations SHOULD set suitable default values for `created_by` based on the principal accessing the systems.
  - `updated_by` string — A string identifier for the entity that updated the Source metadata most recently. Service implementations SHOULD set suitable default values for `updated_by` based on the principal accessing the system.
  - `created` string, date-time — The date-time the Source was created in a given context, e.g. in the service instance. Service implementations SHOULD ignore this if given in a PUT request, and instead manage it internally
  - `updated` string, date-time — The date-time the Source metadata was last updated in a given context, e.g. in the service instance. Service implementations SHOULD ignore this if given in a PUT request, and instead manage it internally
  - `tags` Tags — Key is a freeform string. Value is a freeform string, or an array of freeform strings.
  - `source_collection` Collectionitem[] — List of Sources that are collected together by this Source. This attribute is intended to be read-only. Service implementations SHOULD ignore this if given in a PUT request, and instead manage it internally. Source collections can be inferred from Flow collection definitions.
    - `id` string, required — A Universally Unique Identifier (UUID) as defined in [RFC9562](https://www.rfc-editor.org/rfc/rfc9562)
    - `role` string — The purpose of this element in the collection, primarily intended to be human-readable.
  - `collected_by` Uuid[] — Sources that reference this Source to include it in a collection. This attribute is intended to be read-only. Service implementations SHOULD ignore this if given in a PUT request, and instead manage it internally. Source collections can be inferred from Flow collection definitions.

## Other responses

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

## Changes

> 23 revisions in range; 2 could not be searched.

- **2026-08-10** `73a77c2ab589` — 2 info
  - added the new optional `query` request parameter `reverse_order`
  - added the new optional `query` request parameter `sort_by`
- **2025-10-15** `552be51d35bd` — 1 breaking
  - removed 'propertyNames' constraint from the `items/tags` response property for the status `200`
- **2025-10-15** `8639ecff0b6c` — 2 breaking, 1 info
  - added the pattern `^([^,]+(,[^,]+)*)?$` to the `query` request parameter `tag.{name}`
  - response property `items/tags/additionalProperties/` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
  - added 'propertyNames' constraint to the `items/tags` response property for the status `200`
- **2025-10-06** `0eeba8c316ce` — 1 breaking
  - for the `query` request parameter `format`, the type/format was changed from `string`/`` to `string`/`uri`
- **2025-07-02** `fff531b4534a` — 1 warning
  - removed the optional property `items/source_collection/items/container_mapping` from the response with the `200` status

[Full history](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/sources/get.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)