Skip to Content
API ReferenceEvent Details

Event Details

Get detailed information for a single event, including available markets and metadata.

GET /api/v1/events/{eventId}

AuthenticationPermalink for this section

Requires API key via X-API-Key header, Authorization: Bearer header, or api_key query param. Available to all tiers.

Path ParametersPermalink for this section

ParameterTypeRequiredDescription
eventIdstringYesUnique event identifier (e.g., nba_celtics_lakers_2026-02-08_b3)

Response HeadersPermalink for this section

All responses include standard rate limit and metadata headers:

HeaderDescription
X-RateLimit-LimitMaximum requests per minute for your tier
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetUnix timestamp when the rate limit window resets
X-Data-DelayData delay for your tier (e.g., 0s, 60s)
X-Request-IdUnique request identifier for debugging

Event Detail ObjectPermalink for this section

FieldTypeDescription
idstringCanonical event identifier — the same for every sportsbook covering this event. Use as your primary key for cross-book matching. See Event Matching.
external_idsobjectMap of sportsbook ID to that book’s native event ID (e.g., { "draftkings": "12345", "fanduel": "67890" }). Use these for deep linking back to sportsbook pages.
sportstringSport identifier (e.g., basketball, football)
leaguestringLeague slug (e.g., nba, nfl)
home_teamstringHome team name
away_teamstringAway team name
start_timestringISO 8601 event start time. Absent on a finished event served from retention — test for the key, not for status.
completed_atstringISO 8601 completion time. Present only on status: "final" rows.
statusstringEvent status: upcoming, live, final or unconfirmed. An event is live when our game tracking shows the game in progress, or when several sportsbooks are offering live prices on it. unconfirmed means the live feed stopped carrying the game before it showed an end-of-game state. The last score seen is not a final result, is_live is false and there is no completed_at. Among the events endpoints only this one serves unconfirmed; the /events list never does, and ?status=unconfirmed is not a filter value there. Live Game State shows the same game as an unconfirmed row.
is_livebooleanWhether the game is live: true when status is live.
live_book_countintegerHow many sportsbooks have at least one live price on this event. Always present, 0 when none. It can be above 0 on an event that is not live. On a live event, 0 means our game tracking alone shows the game in progress.
season_typestring"Preseason" or "Regular Season". Omitted when it is not known: a league without a published season calendar (today every league except nba), a date outside the calendar, or an event with no start time. An absent field never means regular season.
event_groupstringCard or tournament label the sportsbooks publish (e.g., UFC Fight Night), the same value as on the /events list. Omitted when no book sends one, and on some finished events.
event_group_slugstringevent_group in URL-safe form (e.g., ufc-fight-night). Present exactly when event_group is.
booksarraySportsbooks covering this event, sorted by market count descending
marketsarrayMarket types available for this event, sorted by selection count descending
last_seenobjectPresent only when status is unconfirmed and your key has the Game State add-on or Enterprise. The last score the live feed showed, described below.
resultobjectPresent only when status is final and your key has the Game State add-on or Enterprise. The final record, described below.
result_accessstringPresent only when status is final or unconfirmed. granted: your key gets result (on final) or last_seen (on unconfirmed). requires_game_state_addon: that object is withheld for your key.
sourcestringconfirmed on a final event whose result was confirmed after the live feed stopped carrying the game. Absent when the live feed showed the end of the game.

Books ArrayPermalink for this section

Each entry in the books array describes a sportsbook that has odds for this event.

FieldTypeDescription
idstringSportsbook identifier (e.g., draftkings, pinnacle)
namestringDisplay name of the sportsbook
market_countintegerNumber of distinct market types this book offers for the event
last_updatestringISO 8601 timestamp of the most recent odds update from this book

Markets ArrayPermalink for this section

Each entry in the markets array summarizes an available market type for this event.

FieldTypeDescription
typestringCanonical market type identifier (e.g., moneyline, point_spread, total_points, player_points)
selection_countintegerNumber of distinct selections available in this market
book_countintegerNumber of sportsbooks offering this market

Last Seen ObjectPermalink for this section

Present only on an unconfirmed event, and only for a key with the Game State add-on or Enterprise. Without the add-on the event still answers status: "unconfirmed", with no last_seen. It holds the last frame the live feed showed before it stopped carrying the game, for example 97-81 at Q4 4:59. It is not a final score, so do not treat it as the result.

FieldTypeDescription
home_scoreintegerHome score in the last frame seen. A set count when score_type is sets
away_scoreintegerAway score in the last frame seen. A set count when score_type is sets
score_typestringsets for tennis, table tennis, volleyball and badminton; points for every other sport
game_periodstringPeriod in the last frame seen (e.g., Q4). Omitted when the feed sent none
game_clockstringGame clock in the last frame seen (e.g., 4:59). Omitted when the feed sent none
seen_atstringISO 8601 time the live feed last showed the game

Result ObjectPermalink for this section

Present only on a final event, and only for a key with the Game State add-on or Enterprise. Without the add-on the event still answers status: "final" and completed_at, with result_access: "requires_game_state_addon" and no result. It is never null or zero-filled, so a missing result never reads as a 0-0 score.

FieldTypeDescription
event_idstringThe event identifier
sportstringSport identifier
leaguestringLeague slug
home_teamstringHome team name
away_teamstringAway team name
final_home_scoreintegerHome final score. A set count when score_type is sets
final_away_scoreintegerAway final score. A set count when score_type is sets
winnerstringhome, away or draw. Omitted when the winner cannot be determined
score_typestringsets for tennis, table tennis, volleyball and badminton; points for every other sport. Omitted on an older record whose scoring cannot be established
period_scoresobjectFinal score per period, keyed by period label (e.g., Q1, OT, 1H, SETS), each { "home", "away" }. Omitted when no breakdown is available
event_completed_atstringSame value as the event’s completed_at

Example RequestsPermalink for this section

curl -X GET "https://api.sharpapi.io/api/v1/events/nba_celtics_lakers_2026-02-08_b3" \ -H "X-API-Key: YOUR_API_KEY"

ResponsePermalink for this section

Success (200)Permalink for this section

Single-resource responses wrap the object in data as a single object (not an array).

{ "data": { "id": "nba_celtics_lakers_2026-02-08_b3", "external_ids": { "draftkings": "12345678", "fanduel": "87654321", "pinnacle": "556677889", "betmgm": "ms_44556" }, "sport": "basketball", "league": "nba", "home_team": "Boston Celtics", "away_team": "Los Angeles Lakers", "start_time": "2026-02-08T19:30:00Z", "status": "upcoming", "is_live": false, "live_book_count": 0, "books": [ { "id": "draftkings", "name": "DraftKings", "market_count": 5, "last_update": "2026-02-08T12:05:00Z" }, { "id": "fanduel", "name": "FanDuel", "market_count": 4, "last_update": "2026-02-08T12:04:30Z" }, { "id": "pinnacle", "name": "Pinnacle", "market_count": 3, "last_update": "2026-02-08T12:03:00Z" }, { "id": "betmgm", "name": "BetMGM", "market_count": 3, "last_update": "2026-02-08T12:02:15Z" } ], "markets": [ { "type": "moneyline", "selection_count": 2, "book_count": 4 }, { "type": "point_spread", "selection_count": 2, "book_count": 4 }, { "type": "total_points", "selection_count": 2, "book_count": 3 }, { "type": "player_points", "selection_count": 18, "book_count": 2 }, { "type": "team_total", "selection_count": 4, "book_count": 1 } ] }, "updated_at": "2026-02-08T12:05:00Z" }

Error ResponsesPermalink for this section

404 Not Found

{ "error": { "code": "not_found", "message": "Event not found" } }

401 Unauthorized

No key supplied returns missing_api_key; a bad key returns invalid_api_key.

{ "error": { "code": "missing_api_key", "message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.", "docs": "https://docs.sharpapi.io/en/authentication#authentication-methods" } }

Use CasesPermalink for this section

  • Cross-book comparison — The canonical id is the same across all sportsbooks, so all odds returned are already matched to the same real-world event. See Event Matching.
  • Market analysis — See every available market type and how many books offer each
  • Sharp reference — Compare soft book odds against Pinnacle (the sharp benchmark)
  • Deep linking — Use external_ids to link users to a specific sportsbook’s event page
Last updated on