Events

For the majority of products available on site, they will be related to a real world event that is occuring, such as a Horse Race, Football match etc. We expose this information as Events. As we can cover many sporting events, these are the generic terms, which can be overloaded with additional properties/types are new sports are added

Key Concepts

Concept	Description
Event Groups	Where events are related to each other, they can be grouped together, event groups could span multiple days, or simply group events together for a given day depending on the sport. Different sports may use alternative terms such as competitions, meetings, torunments, leagues but in effect are all a group of events.
Event	Provide information about the event such as the competitors involved, the results and misc statisics
Venue	The location the event is taking place.
Event Competitors	Those who are involved in the event, such as runners, players etc. The data provided will be related to the competitor at this given event, as such when quering the same competitor at different events the values maybe different such as their official ratings.

RequestResponse

query GetEvents {
  events {
    nodes {
      id
      name
      venue {
        id
        name
        country {
          name
          alpha2Code
        }
      }
      scheduledStartDateTime {
        iso8601
      }
      result {
        status
        results {
          nodes {
            id
            finishingPosition
          }
        }
      }
      eventCompetitors {
        nodes {
          id
          name
          entryStatus
          details {
            ... on HorseDetails {
              clothNumber
            }
            ... on GreyhoundDetails {
              trapNumber
            }
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "events": {
      "nodes": [
        {
          "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415",
          "name": "CARLISLE RACE 3",
          "venue": {
            "id": null,
            "name": "CARLISLE",
            "country": {
              "name": "United Kingdom of Great Britain and Northern Ireland",
              "alpha2Code": "GB"
            }
          },
          "scheduledStartDateTime": {
            "iso8601": "2023-09-13T14:15:00Z"
          },
          "result": {
            "status": "FINAL",
            "results": {
              "nodes": [
                {
                  "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415-MANXMAN",
                  "finishingPosition": "1"
                },
                {
                  "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415-YASMIN-FROM-YORK",
                  "finishingPosition": "3"
                },
                {
                  "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415-AIGHEAR",
                  "finishingPosition": "2"
                }
              ]
            }
          },
          "eventCompetitors": {
            "nodes": [
              {
                "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415-SPANTIK",
                "name": "SPANTIK",
                "entryStatus": "CONFIRMED",
                "details": {
                  "clothNumber": 1
                }
              },
              {
                "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415-HELLENISTA",
                "name": "HELLENISTA",
                "entryStatus": "CONFIRMED",
                "details": {
                  "clothNumber": 2
                }
              },
              {
                "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415-MANXMAN",
                "name": "MANXMAN",
                "entryStatus": "CONFIRMED",
                "details": {
                  "clothNumber": 3
                }
              },
              {
                "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415-YASMIN-FROM-YORK",
                "name": "YASMIN FROM YORK",
                "entryStatus": "CONFIRMED",
                "details": {
                  "clothNumber": 4
                }
              },
              {
                "id": "HORSERACING-CARLISLE-GB-2023-09-13-1415-AIGHEAR",
                "name": "AIGHEAR",
                "entryStatus": "CONFIRMED",
                "details": {
                  "clothNumber": 5
                }
              }
            ]
          }
        }
      ]
    }
  }
}