Fixture Message Structure

Common Header

Field	Type	Notes
MessageId	string (GUID)	Unique per message; GUID/UUID v4
Timestamp	ISO-8601	UTC
MessageType	int (enum)	1 = Fixture, 2 = LiveScore
Fixtureid	String	Unique identifier for the fixture
Leagueid	String	Unique identifier for the League
Sportid	String	Unique identifier for the Sport

---

Fixture

Example

{
  "header": {
    "MessageId": "d9e1a4e6-2a44-4a3d-9bbd-0a9a7f5e1c2d",
    "Timestamp": "2025-11-04T19:45:00Z",
    "MessageType": 1
  },
  "body": {
    "fixtureId": 123456,
    "status": 1,
    "startDate": "2025-11-04T19:45:00Z",
    "sport":    { "id": 6046, "name": "Football" },
    "league":   { "id": 1001, "name": "Premier League" },
    "location": { "id": 250,  "name": "England" },
    "participants": [
      { "id": 9001, "name": "Arsenal", "position": 1 },
      { "id": 9002, "name": "Chelsea", "position": 2 }
    ]
  }
}

---

Fields (body)

Field	Type	Nullable	Notes
fixtureId	int	No	Join key for incidents
status	int (enum)	No	See Fixture Status below
startDate	string (ISO-8601, UTC)	No	Scheduled start
sport	Sport object	No	Sport metadata
league	League object	No	League metadata
location	Location object	No	Country / venue
participants	array of Participant	No	Ordered [home, away]

---

Sport (object)

Field	Type	Nullable	Notes
id	int	No	Sport id
name	string	No	Sport name

League (object)

Field	Type	Nullable	Notes
id	int	No	League id
name	string	No	League name

Location (object)

Field	Type	Nullable	Notes
id	int	No	Location id
name	string	No	Location name

Participant (object)

Field	Type	Required	Notes
id	int	Yes	Participant id
name	string	Yes	Participant name
position	int (enum)	Yes	1 = home, 2 = away

---

Fixture Status (enum)

Value	Name
1	NSY
2	InProgress
3	Finished
4	Cancelled
5	Postponed
6	Interrupted
7	Abandoned
8	LostCoverage
9	AboutToStart