Skip to main content
GET
/
v1
/
events
/
{eventId}
Event Details — Full market depth (1,000+ markets per event)
curl --request GET \
  --url https://api.fieldfunded.com/v1/events/{eventId} \
  --header 'X-API-Key: <api-key>'
{
  "id": "87654321",
  "sport": {
    "key": "soccer",
    "name": "Soccer"
  },
  "league": {
    "slug": "premier-league",
    "name": "Premier League",
    "country": "England"
  },
  "home_team": "Arsenal",
  "away_team": "Chelsea",
  "home_logo": "https://api.fieldfunded.com/api/logo/t-38",
  "away_logo": "https://api.fieldfunded.com/api/logo/t-42",
  "status": "live",
  "start_time": "2026-04-12T15:00:00Z",
  "score": {
    "home": 2,
    "away": 1
  },
  "clock": "67:10 2nd half",
  "period": "2nd Half",
  "odds": {
    "home": 1.45,
    "draw": 4.5,
    "away": 6
  },
  "odds_format": "decimal",
  "markets_count": 72,
  "scoreboard": {
    "headers": [
      "",
      "1st",
      "2nd",
      "T"
    ],
    "home": [
      "",
      "1",
      "1",
      "2"
    ],
    "away": [
      "",
      "0",
      "1",
      "1"
    ]
  },
  "markets": [
    {
      "key": "1x2",
      "name": "Match Winner",
      "outcomes": [
        {
          "label": "Home",
          "odds": 1.45,
          "is_locked": false,
          "team_side": "home"
        },
        {
          "label": "Draw",
          "odds": 4.5,
          "is_locked": false,
          "team_side": null
        },
        {
          "label": "Away",
          "odds": 6,
          "is_locked": false,
          "team_side": "away"
        }
      ]
    },
    {
      "key": "over_under_2_5",
      "name": "Over/Under 2.5",
      "outcomes": [
        {
          "label": "Over 2.5",
          "odds": 1.6,
          "is_locked": false,
          "team_side": null
        },
        {
          "label": "Under 2.5",
          "odds": 2.3,
          "is_locked": false,
          "team_side": null
        }
      ]
    }
  ],
  "updated_at": "2026-04-12T15:67:10Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.fieldfunded.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Your FieldFunded API Key

Path Parameters

​
eventId
string
required

Unique event identifier. Use GET /v1/events to discover active IDs.

Query Parameters

​
odds_format
enum<string>
default:decimal

Odds format for all values in response. Default: decimal

Available options:
decimal,
american,
fractional

Response

Deep, comprehensive details for the specified event, including all available betting markets.

​
id
string
Example:

"87654321"

​
sport
object
​
league
object
​
home_team
string
​
away_team
string

PNG team logo URL. Most major teams have logos; returns a default placeholder when unavailable.

PNG team logo URL. Most major teams have logos; returns a default placeholder when unavailable.

​
status
enum<string>

Event status. delayed = past start time but not live (auto-detected). postponed/suspended trigger the 48-hour settlement timer. cancelled includes walkovers and abandoned games.

Available options:
live,
prematch,
ended,
delayed,
postponed,
cancelled,
suspended,
retired
​
start_time
string<date-time> | null

Scheduled start time in ISO 8601. May be null if the event date is unknown.

​
score
object

Home/away goals or points. A value of 0 is a valid score (for example, 0-0) and is returned as numeric zero.

​
clock
string | null

Current match time (e.g. "67:10 2nd half"). Returns null for sports without a running clock (tennis, darts, CS2, etc.).

​
odds
object

Main market odds (1X2 summary). May be absent or null for events without main market odds.

​
odds_format
enum<string>

Odds format used in this response. Only present when odds are included.

Available options:
decimal,
american,
fractional
​
period
string

Current game period (e.g. '1st Half', '2nd Period', 'Set 3'). Empty string when not applicable.

​
markets_count
integer

Total number of available markets

​
is_delayed
boolean

True when the event is past its scheduled start_time but not yet live. Only present for delayed events.

​
delay_minutes
integer

Minutes since scheduled start_time. Only present when is_delayed is true.

​
updated_at
string<date-time>

ISO 8601 timestamp of when this event data was last polled/updated.

​
scoreboard
object

Detailed period-by-period scores

​
markets
object[]
​
sport_data
object

Sport-specific live data