Match Event Data (SPS) API
This endpoint returns an entire Soccer match event data session in the form of sequential timestamped packets covering an IMGA/Openbet Sports Services (SPS) collected match. The endpoint can be filtered by the specific fixtureId for that match and returns each phase of the match action along with the connected events around each event.
Key information within the response is as follows:
Fixture ID
Player Details, including shirt number
Action type
Clock time
Action Context and MetaData, such as Goals, Fouls, Assists
Period (1st or 2nd Half)
XY coordinate position of player and match event
Parent Action ID, to enable linking preceding events
Team name and details
VAR Decisions and Player Substitutions
Endpoint URLs
Still to be confirmed, likely to be in the form of below:
https://dde-api.data.imgarena.com/soccer/fixture/{fixture_id}/events
Polling Frequency
We recommend the following frequency for your REST requests to ensure that you have the most up-to-date information at all times:
Every 30 seconds for media usage
Required Headers
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
*Authorization header includes a truncated Bearer token, contact IMG for your auth token if you do not have.
Request Parameters
This endpoint currently takes a fixture_id in the url header to fetch the correct fixture.
Response Model
Action Id object
actionId
alpha numeric
actionId is a composite key of matchId , eventId and actionType
actionTypeId
int
The ID of the actionType (Pass, Shot..)
actionTypeMetadata
string
Type of metadata contained in packet (pass, shot, goalkeeperSave..)
clockTime
dateTime
The clock time within the match fixture ("01:41") means 1 minute 41 seconds into the match
period
string
Determined at start of a period of play ("FirstHalf", "FirstHalfExtraTime", "SecondHalf", "SecondHalfExtraTime", "Penalties")
fixtureId
alpha numeric
The match Fixture ID
__time
UTC dateTime
The timestamp of the event which differs from clockTime, for example:
(2024-02-22T01:10:28.953Z)
warnings
string
Any unusual game action/event warning message
messageId
alpha numeric uuid
messageId is a unique ID for each produced packet
team {}
object
Team object containing a team ID and team name details
clockTimeTicks
int
The game clock time in seconds
parentActionId
alpha numeric uuid
parentActionId is a composite key of the preceding connected action to the current one, i.e. the previous action's 'actionId
teamPossessionPhaseId
int
A number that increments per team every time they loose and gain possession
userId
alpha numeric
Administrative procedure to record the Data Collector/Scorer ID who sent the action, for match scoring performance and Quality Assurance
createdAt
UTC dateTime
The timestamp the event was first created
isRemoved
boolean
An indication that this packet should be 'deleted' or removed from records as the data within it has changed, this could be for example a goal packet that has now been ruled out for 'offside/VAR' etc
isSuccessful
boolean
Setting isSuccessful conditionally if the action resulted in a successful completion (successful pass, successful shot on goal)
metadata object { }
object array
This is an array consisting of detailed contextual meta data explaining the action, player and position of the event, wtih details such as type of event (pass, shot), distance of (pass, shot)
player
Player Object Array
Player details including player full name, player ID and player shirt number
Actions List (Listed in 'actionTypeMetadata' object and described in detail in the 'Metadata' object)
All Event Action types that are returned from the endpoint (actionTypeMetadata)
Sample Response Extracts
Last updated