Match Subscription

By subscribing for a match, the client system tells the server that they want to receive data for the specified match. If the match subscription went through successfully, the client system receives a full match message for the match they just subscribed to. Additionally, you will receive delta messages and delta update messages during the match.

XML example - single match

<match matchid="944423"/>

XML example - multiple matches

<matchsubscription>
	<match matchid="1101335"/>
	<match matchid="1062714"/>
</matchsubscription>

XML attributes definition

Element
Attribute
Description
Possible values

match

matchid

The id of the match the client system wants to subscribe to.

Integer

circle-info

Note It is possible to subscribe to multiple matches at the same time. Doing this requires the client system to create a separate <match> element for each match they want to subscribe to, and encapsulate them with <matchsubscription> elements.

circle-info

Note It is possible to subscribe to multiple matches at the same time. Doing this requires the client system to create a separate <match> element for each match they want to subscribe to, and encapsulate them with <matchsubscription> elements.

Match subscription failed

If the client system tries to subscribe to a match they does not have access to they will not receive a full match message, but a match subscription failed message instead. This can occur if the customer in question already has 2 open subscriptions for the match.

XML example

<matchstop matchid="944423" reason="Bookmaker already has maximum number of subscriptions for this match"/>

XML attributes definition

Element
Attributes
Description
Possible values

matchstop

matchid

The id of the match for which the match subscription failed.

Integer

reason

A textual description explaining why the match subscription failed.

String

Last updated

Was this helpful?