---
title: "Get the current state of a media player block."
method: GET
path: "/api/flows/{flow_id}/blocks/{block_id}/player/state"
tags: ["media_player"]
---

# Get the current state of a media player block.

`GET /api/flows/{flow_id}/blocks/{block_id}/player/state`

## Path parameters

- `flow_id` string, required
- `block_id` string, required

## Response `200`

Player state

- PlayerStateResponse — Response with the current player state.
  - `current_file` string, nullable — Current file path/URI
  - `current_file_index` integer, required — Current file index (0-based)
  - `duration_ns` integer, required — Total duration in nanoseconds
  - `loop_playlist` boolean, required — Whether playlist loops
  - `playlist` string[], required — Full playlist
  - `position_ns` integer, required — Current position in nanoseconds
  - `state` 'playing' | 'paused' | 'stopped', required — Playback state of a media player.
  - `total_files` integer, required — Total number of files in playlist

## Other responses

- `404` — Player not found

## Changes

- **2026-04-10** `7d27d1ed89f4` — 3 warning
  - added the new `paused` enum value to the `state` response property for the response status `200`
  - added the new `playing` enum value to the `state` response property for the response status `200`
  - added the new `stopped` enum value to the `state` response property for the response status `200`
- **2026-04-07** `1e67862a080e` — 3 info
  - removed the `paused` enum value from the `state` response property for the response status `200`
  - removed the `playing` enum value from the `state` response property for the response status `200`
  - removed the `stopped` enum value from the `state` response property for the response status `200`

[Change history](https://skmtc.dev/eyevinn/apis/strom-api/changes/api/flows/:flow_id/blocks/:block_id/player/state/get.md)

---

[API](https://skmtc.dev/eyevinn/apis/strom-api.md) · [All operations](https://skmtc.dev/eyevinn/apis/strom-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eyevinn/strom-api/revisions/0df7ca64263f/schema)