Data Exchange
This page presents the procedures that must be followed by gambling service providers for the exchange of data with the HGC.
The recommended method of data exchange between the HGC and the provider is sending data via XML (eXtensible Markup Language) files. The XML language is currently a widespread and open standard for describing and exchanging data. The XML language has been developed and is maintained by the W3C (World Wide Web Consortium).
[Amendment – 29/05/2025] Final Data Models Specifications – Data model specifications to be stored in the License holders’ SAFE systems
- Betting Events: Betting events are recorded [Specifications] [view XSD in GitHub]
- Bettings: Gaming activity and financial data for bets are recorded [Specifications] [view XSD in GitHub]
- Betting Winnings: Gaming activity and financial data for betting results are recorded [Specifications] [view XSD in GitHub]
- EndofDay Bettings: All movements for bettings (gambling activity and financial data) for each gaming day are recorded at an aggregate level [Specifications] [view XSD in GitHub]
- Games: The gaming activity and financial data of other online gambling games are recorded [except Peer to Peer Games and Poker Tournaments] [ Specifications ] [ view XSD in GitHub ]
- EndofDay Games: All movements (gaming activity and financial data) of other online games of chance [except Peer to Peer Poker Games and Poker Tournaments] for each gaming day are recorded at an aggregate level [Specifications] [view XSD in GitHub]
- Peer to Peer Games: The gaming activity and financial data of other peer-to-peer online gambling games (except the “Poker Tournament” game) are recorded [Specifications] [view XSD in GitHub]
- EndofDay PtP Games: All movements (gaming activity and financial data) of other peer-to-peer online gambling games (except the “Poker Tournament” game) for each gaming day are recorded at an aggregate level [Specifications] [view XSD in GitHub]
- Poker Tournament Start: Poker Tournament Ending Data is Recorded [Specifications] [view XSD in GitHub]
- Poker Tournament Transactions: Transactions (financial data) related to Poker Tournaments are recorded [Specifications] [view XSD in GitHub]
- Poker Tournament End: Poker Tournament Ending Data is Recorded [Specifications] [view XSD in GitHub]
- EndofDay Poker Tournaments: All movements (gambling activity and financial data) of Poker Tournament bets for each gaming day are recorded at an aggregate level [Specifications] [view XSD in GitHub]
- Jackpot Parameters: Data related to the configuration and operation of Jackpot Functions is recorded [Specifications] [view XSD in GitHub]
- Jackpot Winnings: Data related to winnings from Jackpot Functions is recorded [Specifications] [view XSD in GitHub]
- Log In Sessions: Gambler session data is recorded [Specifications] [view XSD in GitHub]
- Bonus Schemas: Data related to reward categories is recorded [Specifications] [view XSD in GitHub]
- Exclusions: Gamblers exclusion data is recorded [Specifications] [view XSD in GitHub]
- Limits: Data related to gaming activity limits is recorded [Specifications] [view XSD in GitHub]
- Limits Exceeded: Data is recorded regarding exceeding gaming activity limits [Specifications] [view XSD in GitHub]
- EndofDay Other: All data concerning Gaming Activity Limits, Gambler Exclusions, Rewards, Gambler Electronic Account Balances and Gambler Bank Account Balances of the License Holder for each gaming day are recorded at an aggregate level. Data related to gamblers’ tax for games played in sessions is also recorded. [Specifications] [view XSD in GitHub]
- Customer Account [Amendment – 29/05/2025] : Gamblers’ data is recorded [Specifications] [view XSD in GitHub]
- Customer Account Transactions: Gamblers’ movements (gaming activity and financial data) are recorded [Specifications] [view XSD in GitHub]
- Affiliate Account: Partners’ data is recorded [Specifications] [view XSD in GitHub]
- Affiliate Account Transactions: Affiliates’ financial data is recorded [Specifications] [view XSD in GitHub]
- Taxation Sessions: Data related to the taxation of games conducted in sessions is recorded [Specifications] [view XSD in GitHub]
- Contests-Draws: Data related to competitions-raffles is recorded [Specifications ] [ view XSD in GitHub]
- Common Elements: A data model that includes the common elements of the above Data Models [Specifications] [view XSD in GitHub]
- Manifest model: A control file model [Specifications] [view XSD in GitHub]
- Field Descriptions Manual – A consolidated Excel file with specifications of data [v47] ([v46], [v45], [v44])
- view all XSDs in GitHub
[Amendment – 03/02/2023] Final Reporting Specifications – Specifications regarding the content of reports in the HGC remote access environment in the Central IT System of License Holders
- Reporting Specifications [Specifications] ([Specifications_V30], [Specifications_v29], [Specifications_v28], [Specifications_v27])
Data exchange between HGC and Casino businesses
- Gamblers’ Complaints in Casinos [Specifications] [Instructions] [XSD File] [XML File Sample] – Last modified: 07/06/2023