# Verified event final-result evidence

Read the current ESPN final scores and explicit winner flags for a retained DraftKings event identity.

Canonical page: https://getoddsapi.com/docs/event-results

## Free API key

Get a free GetOdds API key: **1,000 requests per UTC day and 60 per minute, no card**. One key covers REST and the hosted MCP server.

Sign up: https://getoddsapi.com/sign-up?ref=ai-claudebot

## Quickstart

1. Create an account at https://getoddsapi.com/sign-up?ref=ai-claudebot, open https://getoddsapi.com/dashboard and issue a key with the sources you need (draftkings, fanduel, betrivers, prizepicks or underdog). Keep it in a server environment variable named GETODDS_API_KEY.
2. Read current DraftKings NBA spreads with curl:

```bash
curl --fail-with-body "https://getoddsapi.com/api/v1/odds?sport=NBA&market=spread&fresh_only=true&limit=50" \
  -H "Authorization: Bearer $GETODDS_API_KEY"
```

3. The same request in Python (standard library only):

```python
import json, os, urllib.request

req = urllib.request.Request(
    "https://getoddsapi.com/api/v1/odds?sport=NBA&market=spread&fresh_only=true&limit=50",
    headers={"Authorization": "Bearer " + os.environ["GETODDS_API_KEY"]},
)
with urllib.request.urlopen(req) as res:
    rows = json.load(res)["data"]
for row in rows:
    print(row["away"], "at", row["home"], row["side"], row["line"], row["american"], row["observed_at"])
```

4. Check `observed_at`, `age_seconds` and `stale` on every row before using a price. Full reference: https://getoddsapi.com/docs

## Use with Claude (MCP)

```bash
claude mcp add --transport http getodds https://getoddsapi.com/api/mcp \
  --header "Authorization: Bearer $GETODDS_API_KEY"
```

The MCP tools follow the key's source grants and share its allowance. Setup guide: https://getoddsapi.com/use-with-claude

## Pricing

| Plan | Allowance | Price |
| --- | --- | --- |
| Free key | 1,000 requests a day, 60 a minute | $0, no card |
| Developer Bundle | 10,000 requests or credits a month on each of four sources | $149 a month |

Free development allowance: 1,000 requests per UTC day and 60 per minute per account, with no payment step. Paid: the Developer Bundle at $149 per month, with 10,000 monthly requests or credits on each of four sources.
Details: https://getoddsapi.com/bundle

## Guide


Canonical: https://getoddsapi.com/docs/event-results
Reviewed: 2026-11-07 UTC

Read the current ESPN final scores and explicit winner flags for a retained DraftKings event identity.

## Read a retained event result

GET /api/v1/events/{id}/result requires a bearer key granted DraftKings access. Use the source-native event ID returned by the events API. The service verifies that identity in the retained store before making one bounded request to ESPN. One successful read costs one credit; account bookmaker price selection is not required.

Only completed events in post state with a provider STATUS_FINAL status produce a result. Pending, canceled and other nonfinal states return data=[] and result_available=false. Provider failures or malformed evidence return an error, never a void result.

```bash
curl --fail-with-body "https://getoddsapi.com/api/v1/events/espn-draftkings:espn:NFL:401873028/result" -H "Authorization: Bearer $GETODDS_API_KEY"
```

## Preserve provider evidence

Each participant includes its ESPN identity, source score string and explicit winner boolean. If the provider omits winner, it remains null; the API never infers a winner from score comparison. Names and home/away identities are verified against the same provider event.

observed_at means this network receipt. source_updated_at is null because the response does not establish a verified provider-update clock. Repeated requests can return revised provider results, but no prior versions or correction history are stored by this endpoint.

## Event results are not sportsbook settlement

The response explicitly reports settlement_verified=false, correction_history_available=false and bookmaker_void_evidence_available=false. It does not grade a bet or assert book-specific overtime, cancellation, push, void or correction rules.

FanDuel’s separate computed player-prop results include internal void reasons such as missing box scores and unmatched players. Those internal outcomes are not bookmaker void evidence and are not relabeled as settlement here.

## Questions

### Can this settle every market?

No. It exposes current event final-result evidence, not book-specific wager settlement.

### Does a missing result mean the bet was void?

No. Nonfinal state, absent retained identity and provider failure have separate explicit responses.

### Are corrections retained?

This endpoint reads the current provider snapshot. Earlier versions and official bookmaker corrections are not retained.

## Sources

- [Stored event identity](https://getoddsapi.com/docs/sportsbook)
- [API contract](https://getoddsapi.com/openapi.json)
- [Verified event metadata](https://getoddsapi.com/docs/event-metadata)

Independent product; not affiliated with the operators named. No picks or predicted profits.

---

GetOdds is an independent developer product and is not affiliated with any sportsbook or pick’em operator. Prices describe data, not betting advice.