Skip to main content
POST
/
v1
/
events
/
batch
Batch Events — Full market depth for up to 20 events in one request
curl --request POST \
  --url https://api.fieldfunded.com/v1/events/batch \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "ids": [
    "<string>"
  ]
}
'
{
  "events": {
    "87654321": {
      "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",
      "period": "2nd Half",
      "odds": {
        "home": 1.45,
        "draw": 4.5,
        "away": 6
      },
      "odds_format": "decimal",
      "markets_count": 72,
      "markets": [
        {
          "key": "1x2",
          "name": "Match Winner",
          "outcomes": [
            {
              "label": "Home",
              "odds": 1.45
            }
          ]
        }
      ],
      "updated_at": "2026-04-12T15:45:30.000Z"
    },
    "87654322": {
      "id": "87654322",
      "sport": {
        "key": "soccer",
        "name": "Soccer"
      },
      "league": {
        "slug": "la-liga",
        "name": "La Liga",
        "country": "Spain"
      },
      "home_team": "Real Madrid",
      "away_team": "Barcelona",
      "home_logo": "https://api.fieldfunded.com/api/logo/t-2829",
      "away_logo": "https://api.fieldfunded.com/api/logo/t-2817",
      "status": "prematch",
      "start_time": "2026-04-14T20:00:00Z",
      "score": {
        "home": 0,
        "away": 0
      },
      "clock": null,
      "period": "",
      "odds": {
        "home": 2.1,
        "draw": 3.4,
        "away": 3.5
      },
      "odds_format": "decimal",
      "markets_count": 350,
      "markets": [
        {
          "key": "1x2",
          "name": "Match Winner",
          "outcomes": [
            {
              "label": "Home",
              "odds": 2.1
            }
          ]
        }
      ],
      "updated_at": "2026-04-12T18:00:00.000Z"
    }
  },
  "found": 2,
  "requested": 3
}

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

Query Parameters

​
odds_format
enum<string>
default:decimal

Odds format for all values in response. Default: decimal

Available options:
decimal,
american,
fractional

Body

application/json
​
ids
string[]
required

Array of event IDs (max 20). Use GET /v1/events to discover active IDs.

Maximum array length: 20

Response

A dictionary of comprehensive event details mapped by their respective event IDs.

​
events
object
​
found
integer
​
requested
integer