---
title: "Get an event's score"
method: GET
path: "/v1/events/{event_id}/score"
tags: ["events"]
---

# Get an event's score

`GET /v1/events/{event_id}/score`

## Request

- Base URL: `https://lumify.ai`
- URL: `https://lumify.ai/v1/events/{event_id}/score`
- Auth: HTTP bearer

## Path parameters

- `event_id` integer, required: Lumify event ID

## Response `200`

Lightweight score snapshot: status, period, clock, and per-participant scores. Cache TTL is 15 s for in-progress events, 5 min otherwise. Capped at 20 calls/min per key (shared with include_scores list polls). High-frequency pollers should use GET /events/{event_id}/stream (SSE) instead of tight-polling this endpoint.

- ScoreResponse
  - `event_id` integer, required
  - `status` string, nullable
  - `finished` boolean, nullable
  - `period` string, nullable
  - `clock` string, nullable
  - `scores` ScoreEntry[]
    - `role` string, nullable
    - `name` string, nullable
    - `abbreviation` string, nullable
    - `score` string, nullable
    - `is_winner` boolean, nullable
    - `period_scores` object[]
  - `updated_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api.md) · [All operations](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api/revisions/f91ea41a2606?raw)