Documentation Index
Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Attending domain tracks live events you bought tickets for: sports games, concerts, theater, and other one-off events. Events come from two sources:
- Google Calendar — auto-extracts ticketing details from event descriptions when Google’s parsers populate them.
- Gmail — per-vendor parsers for the major ticket sellers, with a universal EventReservation schema parser as a fallback for everything else.
Data syncs daily at 4:00 AM Pacific via cron, with incremental Gmail and Calendar pulls.
Key endpoints
| Endpoint | Description |
|---|
| GET /attending/events | Attended events with filters |
| GET /attending/events/:id | Single event with venue, tickets, and player appearances |
| GET /attending/seasons/:league/:season | Attended games in a sports season with W/L record |
| GET /attending/venues | Venue catalog with city, capacity, and lat/long |
| GET /attending/players | Players you have watched play, with photos |
| GET /attending/players/:id | Player detail with per-event appearance lines |
| GET /attending/stats | Aggregate counts by category, type, and year |
| GET /attending/year/:year | Year in review with monthly breakdown, top venues, top performers |
Event categories
Every event has a top-level category and a more specific event_type:
| Category | Event types |
|---|
sports | mlb_game, nfl_game, nba_game, wnba_game, mls_game, ncaaf_game, ncaab_game |
music | concert |
arts | theater, comedy, other |
Event filters
The events endpoint supports filtering by:
category — sports, music, or arts.event_type — specific event type (e.g., mlb_game, concert).season / year — sports season or calendar year.venue_id — filter to a single venue.attended — 1 for confirmed attendance, 0 for tickets bought but not used, omit for both.
Sports enrichment
Sports events are enriched with team and score data from the MLB Stats API (baseball) and ESPN (NFL, NBA, WNBA, MLS, NCAAF, NCAAB). Each row carries league-specific fields in event_data. For MLB games:
| Field | Description |
|---|
home_team | Full team object (see below) |
away_team | Full team object (see below) |
home_score | Final score for the home team |
away_score | Final score for the away team |
winning_pitcher | Pitcher of record on the winning side |
my_team_won | true if the team you root for won |
home_team and away_team are full team objects. The same shape appears as primary_team on player rows and team on per-game appearances, so consumers never need a second call to render a logo or tint:
| Field | Description |
|---|
id | League-native team id |
abbreviation, name, location | ”SEA”, “Mariners”, “Seattle” |
primary_color, secondary_color, ui_tint_color | Brand hex colors for backgrounds and accents |
logo_url, logo_dark_url, logo_light_url | SVG cap variants for light + dark hosts |
conference, division | League grouping |
attended=1), so a 6-game home season with one no-show reports a 5-1 attended record rather than the team’s full 5-2 record.
For MLB games, per-game box scores resolve into per-player appearance lines (batting line, pitching line, decisions) that surface on the players endpoints. Player photos backfill from MLB Stats and ESPN.
