Basic JSON structure

Products will generally be represented within the following object.

{
  "id": 15085,
  "name": "Arsenal v Newcastle United",
  "type": "football_match",
  "slug": "arsenal-v-newcastle-united",
  "match": {
    // ..
  },
  "event": {
    // ..
  },
  "min_order": 1,
  "max_order": 99,
  "venue": 1003,
  "event_dates": [],
  "images": {
    "main": "",
    "thumb": "path/to/image.jpg"
  }
}

Product types

Depending on the type of a product type record, the match and event properties will be set.

Football matches

Key: football_match

Specific information around a football_match will exist in the match property of a product type object.

{
  // ..
  "match": {
    "start": {
      "tz": "Europe/London",
      "local": "2024-12-07T00:00:00+00:00",
      "utc": "2024-12-07T00:00:00+00:00",
      "epoch": 1733529600
    },
    "time_confirmed": false,
    "home": 1001,
    "away": 1015,
    "competition": 401,
    "status": "Upcoming"
  },
  "event": null
}

Kickoff times

Note that the time_confirmed property is very important. If this value is false the kickoff time of the match may change in the future, usually due to TV scheduling. Once this is true it will not change, outside of any major factor such as force majeure.

Events

Key: event

Specific information around an event will exist in the event property.

{
  // ..
  "match": null,
  "event": {
    "event": {
      "start": {
        "tz": "Europe/London",
        "local": "2024-11-02T19:00:00+00:00",
        "utc": "2024-11-02T19:00:00+00:00",
        "epoch": 1730574000
      },
      "end": {
        "tz": "Europe/London",
        "local": "2024-11-02T23:00:00+00:00",
        "utc": "2024-11-02T23:00:00+00:00",
        "epoch": 1730588400
      },
      "status": "Upcoming"
    },
    "event_dates": [
      {
        "id": 1,
        "date_start": "2024-11-02",
        "date_end": "2024-11-02"
      }
    ]
  }
}

In addition, the event_dates property will contain an array of IDs that correlate to the specific event date records.

{
  // ..
  "event_dates": [
    9
  ],
  // ..
}