# 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](/u/trade/integration/message-structure/outright-livescore.md)        |
| Markets         | array         | An array of [Markets](/u/trade/integration/message-structure/outright-market.md) |
| 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 ](/u/trade/enumerations/fixture-scoreboard-status.md#fixture-scoreboard-status)of the fixture |
| Participants      | array         | An array of [Participants](/u/trade/integration/message-structure/fixture.md#participants)                        |
| ExtraData         | array         | An array of [FixtureExtraData](/u/trade/integration/message-structure/fixture.md#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](/u/trade/integration/message-structure/fixture.md#fixtureplayers). |
| ShirtColor           | string        | **OPTIONAL**: Primary shirt color of the participant.                                                                                                  |
| GoalKeeperShirtColor | string        | **OPTIONAL**: Goalkeeper shirt color of the participant.                                                                                               |
| 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](/u/trade/integration/message-structure/fixture.md#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.                                |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lsports.eu/u/trade/integration/message-structure/outright-fixture.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.