# Outright Fixture

This documentation describes the complete structure of an Outright Fixture Update message (Type 37) as delivered by TRADE.

{% tabs %}
{% tab title="JSON" %}

```json
[
   {
      "Header":{
         "Type":37,
         "MsgSeq":1,
         "MsgGuid":"7b0cadae-0b61-4a3a-a739-718fd0bbce02",
         "CreationDate":"2024-06-25T14:03:24.9538493Z",
         "ServerTimestamp":1719324204953
      },
      "Body":{
         "Competition":{
            "Id":11217,
            "Name":"Antepost",
            "Type":3,
            "Events":[
               {
                  "FixtureId":22751994,
                  "OutrightFixture":{
                     "Subscription":{
                        "Type":2,
                        "Status":1
                     },
                     "Sport":{
                        "Id":687888,
                        "Name":"Horse Racing"
                     },
                     "Location":{
                        "Id":2,
                        "Name":"Great Britain"
                     },
                     "StartDate":"2024-06-26T14:02:59.348219Z",
                     "LastUpdate":"2024-06-25T14:03:04.397273Z",
                     "Status":1,
                     "Participants":[
                        {
                           "Id":51990374,
                           "Name":"Cheltenham",
                           "Position":"1",
                           "IsActive":1,
                           "ExtraData":[
                              {
                                 "Name":"Color",
                                 "Value":"Bay"
                              },
                              {
                                 "Name":"DamSire",
                                 "Value":"Trebrook"
                              },
                              {
                                 "Name":"Gender",
                                 "Value":"Gelding"
                              },
                              {
                                 "Name":"ProviderParticipantId",
                                 "Value":"36961950"
                              },
                              {
                                 "Name":"Sire",
                                 "Value":"Voix Du Nord"
                              }
                           ]
                        },
                        {
                           "Id":51990385,
                           "Name":"Cheltenham Day 3",
                           "Position":"2",
                           "IsActive":1
                        },
                        {
                           "Id":52023599,
                           "Name":"Catterick",
                           "Position":"3",
                           "IsActive":1
                        },
                        {
                           "Id":52027843,
                           "Name":"Cheltenham Day 2",
                           "Position":"4",
                           "IsActive":1
                        },
                        {
                           "Id":52031169,
                           "Name":"Cheltenham Day 1",
                           "Position":"5",
                           "IsActive":1
                        },
                        {
                           "Id":52052758,
                           "Name":"Perth",
                           "Position":"6",
                           "IsActive":1
                        },
                        {
                           "Id":52163726,
                           "Name":"Uttoxeter",
                           "Position":"7",
                           "IsActive":1
                        },
                        {
                           "Id":52193184,
                           "Name":"Chelmsford City",
                           "Position":"8",
                           "IsActive":1
                        }
                     ],
                     "ExtraData":[
                        {
                           "Name":"WithInPlay",
                           "Value":"false"
                        },
                        {
                           "Name":"WithLivescore",
                           "Value":"false"
                        }
                     ]
                  },
                  "Livescore":null,
                  "Markets":null
               }
            ]
         }
      }
   }
]
```

{% endtab %}

{% tab title="XML" %}

```xml
<Header>
	<Type>37</Type>
	<MsgSeq>1</MsgSeq>
	<MsgGuid>7b0cadae-0b61-4a3a-a739-718fd0bbce02</MsgGuid>
	<CreationDate>2024-06-25T14:03:24.9538493Z</CreationDate>
	<ServerTimestamp>1719324204953</ServerTimestamp>
</Header>
<Body>
	<Competition>
		<Id>11217</Id>
		<Name>Antepost</Name>
		<Type>1</Type>
		<Events>
			<FixtureId>22751994</FixtureId>
			<OutrightFixture>
				<Subscription>
					<Type>2</Type>
					<Status>1</Status>
				</Subscription>
				<Sport>
					<Id>687888</Id>
					<Name>Horse Racing</Name>
				</Sport>
				<Location>
					<Id>2</Id>
					<Name>Great Britain</Name>
				</Location>
				<StartDate>2024-06-26T14:02:59.348219Z</StartDate>
				<LastUpdate>2024-06-25T14:03:04.397273Z</LastUpdate>
				<Status>1</Status>
				<Participants>
					<Id>51990374</Id>
					<Name>Cheltenham</Name>
					<Position>1</Position>
					<IsActive>1</IsActive>
					<ExtraData>
						<Name>Color</Name>
						<Value>Bay</Value>
					</ExtraData>
					<ExtraData>
						<Name>DamSire</Name>
						<Value>Trebrook</Value>
					</ExtraData>
					<ExtraData>
						<Name>Gender</Name>
						<Value>Gelding</Value>
					</ExtraData>
					<ExtraData>
						<Name>ProviderParticipantId</Name>
						<Value>36961950</Value>
					</ExtraData>
					<ExtraData>
						<Name>Sire</Name>
						<Value>Voix Du Nord</Value>
					</ExtraData>
				</Participants>
				<Participants>
					<Id>51990385</Id>
					<Name>Cheltenham Day 3</Name>
					<Position>2</Position>
					<IsActive>1</IsActive>
				</Participants>
				<Participants>
					<Id>52023599</Id>
					<Name>Catterick</Name>
					<Position>3</Position>
					<IsActive>1</IsActive>
				</Participants>
				<Participants>
					<Id>52027843</Id>
					<Name>Cheltenham Day 2</Name>
					<Position>4</Position>
					<IsActive>1</IsActive>
				</Participants>
				<Participants>
					<Id>52031169</Id>
					<Name>Cheltenham Day 1</Name>
					<Position>5</Position>
					<IsActive>1</IsActive>
				</Participants>
				<Participants>
					<Id>52052758</Id>
					<Name>Perth</Name>
					<Position>6</Position>
					<IsActive>1</IsActive>
				</Participants>
				<Participants>
					<Id>52163726</Id>
					<Name>Uttoxeter</Name>
					<Position>7</Position>
					<IsActive>1</IsActive>
				</Participants>
				<Participants>
					<Id>52193184</Id>
					<Name>Chelmsford City</Name>
					<Position>8</Position>
					<IsActive>1</IsActive>
				</Participants>
				<ExtraData>
					<Name>WithInPlay</Name>
					<Value>false</Value>
				</ExtraData>
				<ExtraData>
					<Name>WithLivescore</Name>
					<Value>false</Value>
				</ExtraData>
			</OutrightFixture>
			<Livescore></Livescore>
			<Markets></Markets>
		</Events>
	</Competition>
</Body>
```

{% endtab %}
{% endtabs %}

## **Model**

### Competition

| Element | Data Type | Description                        |
| ------- | --------- | ---------------------------------- |
| Id      | int       | The unique ID of the competition   |
| Name    | string    | The competition name               |
| Type    | enum      | Type 3 is League, Type 4 is Season |
| Events  | array     | Array of Events                    |

#### Events

| **Element**     | **Data Type** | **Description**                                                                                      |
| --------------- | ------------- | ---------------------------------------------------------------------------------------------------- |
| FixtureId       | int           | The unique ID of the fixture.                                                                        |
| Livescore       | object        | [Livescore](https://docs.lsports.eu/u/trade/integration/message-structure/outright-livescore)        |
| Markets         | array         | An array of [Markets](https://docs.lsports.eu/u/trade/integration/message-structure/outright-market) |
| OutrightFixture | object        | OutrightFixture                                                                                      |

#### OutrightFixture

|                   |               |                                                                                                                                 |
| ----------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Element**       | **Data Type** | **Description**                                                                                                                 |
| Subscription      | object        | [Subscription](#subscription)                                                                                                   |
| ExternalFixtureId | string        | Use to map fixtures to an external provider; to enable this feature, please contact your CSM.                                   |
| Sport             | object        | [Sport](#sport)                                                                                                                 |
| Location          | object        | [Location](#location)                                                                                                           |
| StartDate         | string        | The fixture start date                                                                                                          |
| LastUpdate        | string        | ISO timestamp of the last update to the provider odds                                                                           |
| Status            | enum          | The current [status ](https://docs.lsports.eu/u/enumerations/fixture-scoreboard-status#fixture-scoreboard-status)of the fixture |
| Participants      | array         | An array of [Participants](https://docs.lsports.eu/u/trade/integration/fixture#participants)                                    |
| ExtraData         | array         | An array of [FixtureExtraData](https://docs.lsports.eu/u/trade/integration/fixture#fixtureextradata)                            |

#### Subscription

|             |               |                                                              |
| ----------- | ------------- | ------------------------------------------------------------ |
| **Element** | **Data Type** | **Description**                                              |
| Type        | enum          | Your package type                                            |
| Status      | enum          | The current subscription status of the event in your package |

#### Sport

|             |               |                            |
| ----------- | ------------- | -------------------------- |
| **Element** | **Data Type** | **Description**            |
| Id          | int           | The unique ID of the sport |
| Name        | string        | The name of the sport      |

#### Location

|             |               |                               |
| ----------- | ------------- | ----------------------------- |
| **Element** | **Data Type** | **Description**               |
| Id          | int           | The unique ID of the location |
| Name        | string        | The name of the location      |

#### Participants

| **Element**    | **Data Type** | **Description**                                                                                                                                          |
| -------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Id             | int           | The unique ID of the participant                                                                                                                         |
| Name           | string        | The name of the participant                                                                                                                              |
| Position       | string        | <p>In 2-participant events the positions will be 1 (home) or 2 (away)<br></p>                                                                            |
| RotationId     | int           | **OPTIONAL**: Rotation identifier for the participant                                                                                                    |
| IsActive       | bool          | Will only show in outright events.                                                                                                                       |
| Gender         | int           | **OPTIONAL**: Gender of the participant. 1 = Men, 2 = Women, 3 = Mix                                                                                     |
| AgeCategory    | int           | **OPTIONAL**: Age category of the participant. 0 = Regular, 1 = Youth, 2 = Reserves                                                                      |
| Type           | int           | **OPTIONAL**: Participant type. 1 = Club, 2 = National, 3 = Individual, 4 = Virtual, 5 = Esports, 6 = VirtuReal, 7 = Doubles                             |
| Form           | string        | **OPTIONAL**: Recent form of the participant (e.g. `WWDLW`).                                                                                             |
| Formation      | string        | **OPTIONAL**: Tactical formation used by the participant (e.g. `4-3-3`).                                                                                 |
| FixturePlayers | array         | **OPTIONAL**: Lineup / roster information for the participant. See [FixturePlayers](https://docs.lsports.eu/u/trade/integration/fixture#fixtureplayers). |
| ExtraData      | array         | Array of data [ExtraData](#extradata)                                                                                                                    |

#### ExtraData

| **Element** | **Data Type** | **Description**                   |
| ----------- | ------------- | --------------------------------- |
| Value       | string        | Representing the extra data value |
| Name        | string        | The name of extra data field      |

### Venue

| **Element**      | **Data Type** | **Description**                                                                                                                                  |
| ---------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Id               | string        | The unique identifier of the venue where the fixture is held                                                                                     |
| Name             | string        | The official name of the venue where the fixture is held                                                                                         |
| Capacity         | int           | The maximum number of spectators that the venue can accommodate.                                                                                 |
| Attendance       | int           | The number of spectators present at the fixture.                                                                                                 |
| CourtSurfaceType | string        | <p>The surface type for sports like tennis.<br><em>Example: Grass, Clay, Hardcourt</em></p>                                                      |
| Environment      | string        | Indicates if the venue is indoors or outdoors.                                                                                                   |
| Assignment       | string        | Specifies whether the venue is assigned as Home, Away, or Neutral                                                                                |
| Country          | object        | Contains the country details where the venue is located. Same values as [Location](https://docs.lsports.eu/u/trade/integration/fixture#location) |
| State            | object        | Contains the state or region details if applicable.                                                                                              |
| City             | object        | Contains the city details where the venue is located.                                                                                            |

### Country

| **Element** | **Data Type** | **Description**            |
| ----------- | ------------- | -------------------------- |
| ID          | int           | Country unique identifier. |
| Name        | string        | Country name.              |

### State

| **Element** | **Data Type** | **Description**          |
| ----------- | ------------- | ------------------------ |
| ID          | int           | State unique identifier. |
| Name        | string        | State name.              |

### City

| **Element** | **Data Type** | **Description**         |
| ----------- | ------------- | ----------------------- |
| ID          | int           | City unique identifier. |
| Name        | string        | City name.              |

### Stage

| **Element** | **Data Type** | **Description**                                       |
| ----------- | ------------- | ----------------------------------------------------- |
| ID          | int           | Unique identifier representing the competition stage. |
| Name        | string        | The name of the competition phase.                    |

### Round

| **Element** | **Data Type** | **Description**                                                |
| ----------- | ------------- | -------------------------------------------------------------- |
| ID          | int           | Unique identifier representing the round within a competition. |
| Name        | string        | The official name of the round.                                |
