List events
GET /api/v1/games/:game_id/events
Returns paginated events for a game.
curl https://app.framesports.com/api/v1/games/game_abc123/events \
-H "Authorization: Bearer your-api-token"
{
"links": {
"first": "/api/v1/games/game_abc123/events?page=1",
"next": "/api/v1/games/game_abc123/events?page=2",
"last": "/api/v1/games/game_abc123/events?page=5"
},
"data": [
{
"id": "ev_abc123",
"caption": "Positive Carry - Player #7",
"player_number": 7,
"team": "Home",
"start_timestamp": 125.4,
"end_timestamp": 130.2
}
]
}
Response fields
| Field | Type | Description |
|---|
id | string | Prefixed event ID |
caption | string | Event description encoding the event type and player |
player_number | integer | Jersey number of the player involved (may be null for team events) |
team | string | "Home" or "Opp" |
start_timestamp | float | Start time in seconds from video start |
end_timestamp | float | End time in seconds from video start |
links.next URL to fetch the next page. The links object includes first, next, prev, and last as available.
Event captions
Event captions encode the type of play. Some examples:
| Caption pattern | Meaning |
|---|
Positive Carry - Player #7 | Home team carry by jersey 7 |
Tackle Missed - Player #3 | Home team missed tackle by jersey 3 |
Try | Opposition try (no player number = opponent) |
Lineout Won (5 players) | Home lineout with detail |