---
title: "List play moments grouped into spans"
method: GET
path: "/v1/play_moments/spans"
tags: ["PlayMoments"]
---

# List play moments grouped into spans

`GET /v1/play_moments/spans`

## Request

- Base URL: `https://api.hify.club`
- URL: `https://api.hify.club/v1/play_moments/spans`
- Auth: API key in header `X-User-Token`

Groups the same play moment groups returned by GET /v1/play_moments into spans. A span is every play moment group of one annotation task that has the exact same start_tick and end_tick. Each entry in ticks has the same shape as an item from GET /v1/play_moments, so it can be passed unchanged to POST /v1/play_moments, bulk_review and bulk_delete. Accepts the same filters as GET /v1/play_moments. Spans are ordered by their earliest occurred_at, and page, per_page, X-Total-Count and X-Total-Pages count spans, not ticks.

## Query parameters

- `page` integer
- `per_page` integer
- `annotation_task_id` integer
- `arena_id` integer
- `start_time` string, date-time
- `end_time` string, date-time
- `moment` string
- `tag` string
- `player_first_name` string
- `player_last_name` string
- `mode` string
- `verification` string
- `is_epic` boolean

## Response `200`

Successful response

- object[]
  - `annotation_task_id` integer
  - `start_tick` integer: Shared start_tick of every play moment group in the span
  - `end_tick` integer: Shared end_tick of every play moment group in the span
  - `occurred_at` string, date-time: Earliest occurred_at across the span's play moment groups
  - `ticks` object[]: The span's play moment groups, ordered by tick. Same shape as an item from GET /v1/play_moments.

## Other responses

- `403`: Forbidden for non-admin users

---

[API](https://skmtc.dev/hify/apis/hify-apis.md) - [All operations](https://skmtc.dev/hify/apis/hify-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/hify/apis/hify-apis/revisions/b5920403538d?raw)