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
| Parameter | Type | Required | Description |
|---|---|---|---|
eventId | string | Yes | Unique 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:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests per minute for your tier |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Unix timestamp when the rate limit window resets |
X-Data-Delay | Data delay for your tier (e.g., 0s, 60s) |
X-Request-Id | Unique request identifier for debugging |
Event Detail ObjectPermalink for this section
| Field | Type | Description |
|---|---|---|
id | string | Canonical event identifier — the same for every sportsbook covering this event. Use as your primary key for cross-book matching. See Event Matching. |
external_ids | object | Map 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. |
sport | string | Sport identifier (e.g., basketball, football) |
league | string | League slug (e.g., nba, nfl) |
home_team | string | Home team name |
away_team | string | Away team name |
start_time | string | ISO 8601 event start time. Absent on a finished event served from retention — test for the key, not for status. |
completed_at | string | ISO 8601 completion time. Present only on status: "final" rows. |
status | string | Event 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_live | boolean | Whether the game is live: true when status is live. |
live_book_count | integer | How 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_type | string | "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_group | string | Card 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_slug | string | event_group in URL-safe form (e.g., ufc-fight-night). Present exactly when event_group is. |
books | array | Sportsbooks covering this event, sorted by market count descending |
markets | array | Market types available for this event, sorted by selection count descending |
last_seen | object | Present 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. |
result | object | Present only when status is final and your key has the Game State add-on or Enterprise. The final record, described below. |
result_access | string | Present 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. |
source | string | confirmed 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.
| Field | Type | Description |
|---|---|---|
id | string | Sportsbook identifier (e.g., draftkings, pinnacle) |
name | string | Display name of the sportsbook |
market_count | integer | Number of distinct market types this book offers for the event |
last_update | string | ISO 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.
| Field | Type | Description |
|---|---|---|
type | string | Canonical market type identifier (e.g., moneyline, point_spread, total_points, player_points) |
selection_count | integer | Number of distinct selections available in this market |
book_count | integer | Number 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.
| Field | Type | Description |
|---|---|---|
home_score | integer | Home score in the last frame seen. A set count when score_type is sets |
away_score | integer | Away score in the last frame seen. A set count when score_type is sets |
score_type | string | sets for tennis, table tennis, volleyball and badminton; points for every other sport |
game_period | string | Period in the last frame seen (e.g., Q4). Omitted when the feed sent none |
game_clock | string | Game clock in the last frame seen (e.g., 4:59). Omitted when the feed sent none |
seen_at | string | ISO 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.
| Field | Type | Description |
|---|---|---|
event_id | string | The event identifier |
sport | string | Sport identifier |
league | string | League slug |
home_team | string | Home team name |
away_team | string | Away team name |
final_home_score | integer | Home final score. A set count when score_type is sets |
final_away_score | integer | Away final score. A set count when score_type is sets |
winner | string | home, away or draw. Omitted when the winner cannot be determined |
score_type | string | sets for tennis, table tennis, volleyball and badminton; points for every other sport. Omitted on an older record whose scoring cannot be established |
period_scores | object | Final score per period, keyed by period label (e.g., Q1, OT, 1H, SETS), each { "home", "away" }. Omitted when no breakdown is available |
event_completed_at | string | Same value as the event’s completed_at |
Example RequestsPermalink for this section
cURL
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
idis 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_idsto link users to a specific sportsbook’s event page
Related EndpointsPermalink for this section
- Events - List and search events
- Event Odds - Get paginated odds for this event
- Event Markets - Get available market types for this event
- Odds Snapshot - Get current odds across all events