Fixture Message Structure

For each message type, fields that are null are omitted from the payload to deliver the lightest possible message.

Common Header

Field	Type	Nullable	Notes
MessageId	string (GUID)	No	Unique per message; UUID v4
Timestamp	ISO-8601 (UTC)	No	UTC
MessageType	int (enum)	No	1 = Fixture, 3 = Tips

Fixtures (shared contract)

{
  "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 tips/incidents
status	int (numeric enum)	No	See Fixture Status (numeric enum)
startDate	ISO-8601 (UTC)	No	Scheduled start
sport.id / sport.name	int / string	No	Sport metadata
league.id / league.name	int / string	No	League metadata
location.id / location.name	int / string	No	Country/venue
participants	array of Participant objects	No	Ordered by position (home/away)

Participant (object)

Field	Type	Nullable	Notes
id	int	No	Participant id
name	string	No	Participant name
position	int (numeric enum)	No	1 = home, 2 = away

Fixture Status (numeric enum)

Value	Name	Description
1	NSY	Fixture is in the pre-match phase (not started yet).
2	InProgress	Fixture is live and currently in play.
3	Finished	Fixture has ended and results are confirmed.
4	Cancelled	Event will not take place or requires recreation under a new Id.
5	Postponed	Fixture is postponed; may later return to NSY with an updated start time.
6	Interrupted	Temporarily stopped (e.g., weather); resumes under the same fixture Id.
7	Abandoned	Permanently stopped and will not resume.
8	LostCoverage	Coverage lost; may later become InProgress/Interrupted/Abandoned/Finished.
9	AboutToStart	Fixture is about to begin shortly.