# FieldFunded API

## Docs

- [Get Event Details](https://docs.fieldfunded.com/api-reference/events/get-event-details.md): Returns complete event details including all available betting markets,  detailed scoreboard with period scores, and sport-specific data  (serving indicators for tennis, power play for hockey, etc.).
- [Get Events](https://docs.fieldfunded.com/api-reference/events/get-events.md): Returns a paginated list of sports events. Filter by sport, league, or status. Results are sorted by start time (live events first, then upcoming).
- [Get Events Batch](https://docs.fieldfunded.com/api-reference/events/get-events-batch.md): Fetch full details for up to 20 events in a single request. More efficient than individual requests. Returns **400 Bad Request** if more than 20 IDs are provided.
- [Get Featured Games](https://docs.fieldfunded.com/api-reference/events/get-featured-games.md): Returns top games from **priority leagues** —  the biggest matches happening now or coming up soon. Live games are shown first, followed by nearest upcoming.
- [Search Events](https://docs.fieldfunded.com/api-reference/events/search-events.md): Search for events by team name or league name. Returns matching events across all sports. Supports partial matching.
- [Get Live Events](https://docs.fieldfunded.com/api-reference/live/get-live-events.md): Returns all currently live in-play events across all sports. This is a **lightweight listing endpoint** — each event includes real-time scores, match clocks, event metadata, summary 1X2 odds (`odds.home`, `odds.draw`, `odds.away`), and a `markets_count` field, but **does NOT include the full `market…
- [Get Scores](https://docs.fieldfunded.com/api-reference/live/get-scores.md): Returns live scores for all in-play events. Matches that recently ended are kept in the response for a 5-minute buffer window so your polling system can safely capture the final score before it is removed. Lightweight endpoint optimized for frequent polling — returns only score data, no markets.
- [Get Event Odds](https://docs.fieldfunded.com/api-reference/odds/get-event-odds.md): Returns current odds for all markets of a specific event without the full event envelope (scores, metadata, etc.).
- [Get Outright Detail](https://docs.fieldfunded.com/api-reference/outrights/get-outright-detail.md): Returns all **outright/futures markets and odds** for a specific tournament.
- [Get Outright Sports](https://docs.fieldfunded.com/api-reference/outrights/get-outright-sports.md): Discovers which sports currently have outright (futures) markets available. Returns sport IDs and tournament counts — use these IDs with `/v1/outrights?sport_id=X`.
- [Get Outrights](https://docs.fieldfunded.com/api-reference/outrights/get-outrights.md): Returns tournaments that have **outright (futures) markets** — long-term bets like "Who will win the Premier League?" or "Ballon d'Or winner".
- [Get Event Result](https://docs.fieldfunded.com/api-reference/results/get-event-result.md): Returns the official score/state for an event result. Available automatically as soon as the game finishes — no developer action required. This endpoint is **score-only** and does not return market-level resolutions. For market outcomes (`won`/`lost`/`refund` with `market_id` and `selection_id`), us…
- [Check Bets](https://docs.fieldfunded.com/api-reference/settlement/check-bets.md): Submit your users' bet selections and check their resolution status — the API automatically determines if each bet `won`, `lost`, `refund`, or is still `pending`. Each selection is matched by `market` name and `outcome` label (with smart alias handling for common variants like "Match Winner" / "1X2"…
- [Check Parlay](https://docs.fieldfunded.com/api-reference/settlement/check-parlay.md): Submit a multi-leg parlay and get the combined resolution. The API resolves each leg individually by matching `market` name and `outcome` label, then calculates the combined payout. For maximum accuracy, include `market_id` and `selection_id` (from `/events` or `/settlements`).
- [Get Outright Settlements](https://docs.fieldfunded.com/api-reference/settlement/get-outright-settlements.md): Returns settled outcomes for outright/futures markets (tournament-level settlements). This endpoint is separate from `/v1/settlements`, which is match/event settlement only.
- [Get Settlements](https://docs.fieldfunded.com/api-reference/settlement/get-settlements.md): Fully automatic — markets resolve without developer intervention as soon as a game ends.
- [Get Leagues](https://docs.fieldfunded.com/api-reference/sports/get-leagues.md): Returns all active leagues with event counts, grouped by sport. Each league includes a `slug` that can be used as a stable identifier for filtering via `/v1/events?league={slug}`.
- [Market Discovery](https://docs.fieldfunded.com/api-reference/sports/get-markets.md): Discovers all known market types currently available, grouped by sport. Samples active events to extract available market names and keys. Useful for building market selectors, mapping market keys to display names, and understanding coverage.
- [Get Sports](https://docs.fieldfunded.com/api-reference/sports/get-sports.md): Returns all sports that currently have active events (live or prematch). Includes event counts per sport.
- [Health Check](https://docs.fieldfunded.com/api-reference/system/get-health.md): Reports the health of the API, including service connectivity, data freshness, and uptime. Returns HTTP 200 when healthy, HTTP 503 when degraded. Use this for monitoring dashboards.
- [API Status](https://docs.fieldfunded.com/api-reference/system/get-status.md): Returns current API health, data freshness timestamps, and global event counts. **No authentication required** — safe to call from status pages, monitoring dashboards, or public health checks.
- [Ping](https://docs.fieldfunded.com/api-reference/system/ping.md): Ultra-lightweight endpoint for uptime monitoring. Returns immediately with minimal payload.
- [Get Usage](https://docs.fieldfunded.com/api-reference/usage/get-usage.md): Returns your current API usage statistics including today's requests, monthly quota consumption, remaining requests, average response time, and error counts. Also includes a 30-day daily breakdown.
- [Get Usage by Endpoint](https://docs.fieldfunded.com/api-reference/usage/get-usage-endpoints.md): Returns request counts per endpoint for the current billing month, sorted by volume (highest first).
- [Get Usage Warnings](https://docs.fieldfunded.com/api-reference/usage/get-usage-warnings.md): Returns any active warnings for your API key, including quota threshold alerts and elevated error rate notifications.
- [Authentication](https://docs.fieldfunded.com/authentication.md): How to authenticate with the FieldFunded API
- [Errors](https://docs.fieldfunded.com/errors.md): Standard error codes and handling
- [FieldFunded Sports API](https://docs.fieldfunded.com/introduction.md): Real-time sports data API covering 30+ sports & esports and 1,000+ betting markets per event.
- [Quickstart](https://docs.fieldfunded.com/quickstart.md): Get live odds, scores, and settlements running in under 5 minutes
- [Rate Limits](https://docs.fieldfunded.com/rate-limits.md): Understanding request limits and quotas
- [Event Statuses](https://docs.fieldfunded.com/reference/event-statuses.md): Possible event status values
- [Market Types](https://docs.fieldfunded.com/reference/market-types.md): Available betting market types and their stable identifiers
- [Supported Sports](https://docs.fieldfunded.com/reference/supported-sports.md): Complete list of supported sports and esports
- [Visual Assets](https://docs.fieldfunded.com/reference/visual-assets.md): PNG team logos (~85% coverage), PNG & SVG team logos for featured leagues, SVG league logos, 182 SVG country flags and custom SVG sport icons
- [SDK & Integration Guide](https://docs.fieldfunded.com/sdk.md): Official SDKs and multi-language integration patterns for FieldFunded API

## OpenAPI Specs

- [openapi](https://docs.fieldfunded.com/openapi.yaml)

## Optional

- [Dashboard](https://fieldfunded.com/portal)
- [Get API Key](mailto:support@fieldfunded.com?subject=API%20Key%20Request&body=Hi%2C%20I%20would%20like%20to%20request%20an%20API%20key.%0A%0AExpected%20volume%3A%20%0AUse%20case%3A%20)
- [API Status](https://api.fieldfunded.com/v1/system/health)
- [Support Email](mailto:support@fieldfunded.com)