---
title: "Media Object Information"
method: GET
path: "/objects/{objectId}"
tags: ["Objects"]
---

# Media Object Information

`GET /objects/{objectId}`

Contains flows that references the media object and other information.

The paging query parameters and headers are required for the list of flow references in the media object.
API implementations should return a complete list of flow references within reason and API clients should expect
paging to happen in some rare cases where a media object is used in many flows.

## Path parameters

- `objectId` string, required

## Query parameters

- `page` string
- `limit` integer

## Response `200`

- Object — Describes a media object in the store.
  - `id` string, required — The media object identifier.
  - `referenced_by_flows` string[], required — List of Flows that reference this media object via Flow Segments in this store.
  - `first_referenced_by_flow` string — The first Flow that had a Flow Segment reference the media object in this store. This Flow is also present in 'referenced_by_flows' if it is still referenced by the Flow. This property is optional and may in some implementations become unset if the Flow no longer references the media object, e.g. because it was deleted.

## Other responses

- `400` — Bad request. Invalid query options.
- `404` — The requested media object does not exist.

## Changes

- **2025-07-02** `fff531b4534a` — 1 breaking, 1 info
  - removed the required property `object_id` from the response with the `200` status
  - added the required property `id` to the response with the `200` status
- **2025-06-11** `e3d4dd57646b` — 1 info
  - endpoint added
- **2025-04-24** `b01aaf8cffe2` — 1 breaking
  - api path removed without deprecation

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