Type: GET
This returns a detailed representation of the current state of the match. The response is a JSON string, which can be parsed with any standard JSON parser.
Example response (formatted for readability):
{
"client_name": "Timemaster111",
"sessionid": "1C32B3DA-F1F6-4B17-8BAE-FD1BC59C28BD",
"sessionip": "184.154.39.222",
"match_type": "Echo_Arena", // "Echo_Arena_Private", "Echo_Arena", "Social_2.0", "INVALID GAMETYPE"
"map_name": "mpl_arena_a", // "mpl_arena_a", "mpl_lobby_b2", "INVALID LEVEL"
"game_clock": 215.09978,
"game_clock_display": "03:35.09",
"private_match": false,
"total_round_count": 1,
"blue_round_score": 0,
"orange_round_score": 0,
"blue_points": 2,
"orange_points": 4,
"tournament_match": false,
"blue_team_restart_request": 0,
"orange_team_restart_request": 0,
"right_shoulder_pressed": 0.0,
"right_shoulder_pressed2": 0.0,
"left_shoulder_pressed": 0.0,
"left_shoulder_pressed2": 0.0,
"packet_loss_ratio": TBC,
"game_status": "score", // "pre_match", "round_start", "playing", "score", "round_over", "round_start", "post_match", "pre_sudden_death", "sudden_death", "post_sudden_death"
"pause": {
"paused_state": "unpaused", // "unpaused", "unpausing", "paused", "paused_requested"
"unpaused_team": "none", // "orange", "blue", "none"
"paused_requested_team": "none", // "orange", "blue", "none"
"unpaused_timer": 0.0,
"paused_timer": 0.0
},
"possession": [
1,
0
],
"last_throw": {
"arm_speed": 0.0,
"total_speed": 0.0,
"off_axis_spin_deg": 0.0,
"wrist_throw_penalty": 0.0,
"rot_per_sec": 0.0,
"pot_speed_from_rot": 0.0,
"speed_from_arm": 0.0,
"speed_from_movement": 0.0,
"speed_from_wrist": 0.0,
"wrist_align_to_throw_deg": 0.0,
"throw_align_to_movement_deg": 0.0,
"off_axis_penalty": 0.0,
"throw_move_penalty": 0.0
},
"last_score": {
"disc_speed": 0.0,
"team": "orange", // "orange", "blue", "none"
"goal_type": "SLAM DUNK", // "[NO GOAL]", "SLAM DUNK", "INSIDE SHOT", "LONG SHOT", "BOUNCE SHOT", "LONG BOUNCE SHOT", "BUMPER_SHOT" (TBC)
"point_amount": 2,
"distance_thrown": 0.40054435,
"person_scored": "Bob",
"assist_scored": "[INVALID]"
},
"disc": {
"position": [
0.0,
0.0,
0.0
],
"forward": [
0.0,
0.0,
1.0
],
"left": [
1.0,
0.0,
0.0
],
"up": [
0.0,
1.0,
0.0
],
"velocity": [
0.0,
0.0,
0.0
],
"bounce_count": 0
},
"player": {
"vr_left": [
0.78700006,
0.072000004,
0.61300004
],
"vr_position": [
-3.9650002,
2.2310002,
-34.506001
],
"vr_forward": [
-0.61700004,
0.091000006,
0.78200006
],
"vr_up": [
0.0,
0.99300003,
-0.116
]
},
"teams": [
{
"team": "BLUE TEAM",
"possession": false,
"stats": {
"points": 2,
"possession_time": 32.055771,
"interceptions": 0,
"blocks": 0,
"steals": 1,
"catches": 0,
"passes": 0,
"saves": 3,
"goals": 0,
"stuns": 6,
"assists": 1,
"shots_taken": 0
},
"players": [
{
"name": "Timemaster111",
"playerid": 0,
"userid": 3561909181390317,
"number": 5,
"level": 50,
"ping": 48,
"stunned": false,
"invulnerable": false,
"possession": false,
"holding_left": "none",
"holding_right": "none",
"blocking": false,
"stats": {
"possession_time": 8.9302616,
"points": 0,
"saves": 1,
"goals": 0,
"stuns": 3,
"passes": 0,
"catches": 0,
"steals": 0,
"blocks": 0,
"interceptions": 0,
"assists": 0,
"shots_taken": 0
},
"velocity": [
0.48200002,
0.83300006,
-2.3240001
],
"head": {
"position": [
-2.1360002,
2.098,
-33.876003
],
"forward": [
0.14600001,
-0.36400002,
0.92000002
],
"left": [
0.98400003,
-0.045000002,
-0.17400001
],
"up": [
0.105,
0.93000007,
0.35200003
]
},
"body": {
"position": [
-2.1360002,
2.098,
-33.876003
],
"forward": [
0.296,
0.001,
0.95500004
],
"left": [
0.95500004,
-0.0020000001,
-0.296
],
"up": [
0.001,
1.0,
-0.001
]
},
"rhand": {
"pos": [
-2.3390002,
1.8030001,
-33.733002
],
"forward": [
-0.259,
0.74000001,
0.62
],
"left": [
0.80900002,
-0.18400002,
0.55800003
],
"up": [
0.52700001,
0.64700001,
-0.55200005
]
},
"lhand": {
"pos": [
-2.0700002,
1.8610001,
-33.788002
],
"forward": [
-0.44800001,
0.73100001,
0.51500005
],
"left": [
0.89200002,
0.32200003,
0.317
],
"up": [
0.066,
0.60100001,
-0.79600006
]
},
},
{
/* ... more players ... */
}
]
},
{
"team": "ORANGE TEAM",
/* ... same as blue team ... */
},
{
"team": "SPECTATORS",
/* ... same as blue team ... */
}
]
}
The response is a JSON object, with the following properties:
The username of the signed-in user.
A 128-bit string-encoded GUID of the session.
IP address to the current server
Represents the type of match being played.
Possible values:
"Echo_Arena_Private""Echo_Arena""Social_2.0""INVALID GAMETYPE"
Name of the map being played.
Possible values:
"mpl_arena_a"- Standard Echo Arena map"mpl_lobby_b2"- Lobby"INVALID LEVEL"
Current game time in seconds.
Current game time as shown in game.
Whether the current session is a private lobby.
Total number of rounds to be played in the match.
Total number of rounds that blue has won.
Total number of rounds that orange has won.
Number of points blue has scored this round.
Number of points orange has scored this round.
Whether the current session is being used for an official tournament orchestrated in collaboration with the Echo Arena developers. This is for possible future integration with ESL and other organized tournaments.
Whether or not the blue team is requesting a restart.
Whether or not the orange team is requesting a restart.
Touch controller input
Touch controller input
Touch controller input
Touch controller input
Number of packets missed bu the client out of the total number of packets sent by the server in a 5 second window.
The current game's status.
Possible values:
"pre_match""round_start""playing""score""round_over""round_start""post_match""pre_sudden_death""sudden_death""post_sudden_death"
Details about whether the game is currently paused.
Current pause state of the match.
Possible values:
"unpaused""unpausing""paused""paused_requested"
Team that unpaused the game.
Possible values:
"orange""blue""none"
Team that pressed the pause button.
Possible values:
"orange""blue""none"
Time until gameplay will resume.
Time since game was paused.
Team and player currently in possession of the disc.
possession[0] is the team in possession and possession[1] is the player in that team.
Info about the last throw made in game by the client user.
Speed of the arm during the last throw.
Combination of all speed factors that went into the disc.
Last score made in the game.
Speed of the disc when it went into the goal.
Team that scored the last goal.
"blue""orange"
A human-readable explanation of the type of goal scored. This is "[NO GOAL]" by default when no goal has been scored.
Possible values:
"[NO GOAL]""SLAM DUNK""INSIDE SHOT""LONG SHOT""BOUNCE SHOT""LONG BOUNCE SHOT""BUMPER_SHOT"(TBC)
The number of points scored (2 or 3). This is 0 by default when no goal has been scored.
The distance the goal was scored from. This is 0 by default when no goal has been scored.
The username of the player who scored the goal. This is "[INVALID]" by default when no goal has been scored since you first joined the match.
The username of the player who assisted the goal. This is "[INVALID]" by default when no goal has been scored since you first joined the match, or when a goal was scored, but no player was credited with the assist.
An object representing the current state of the disk.
An array representing the disk's position within the arena.
The direction that the disc is facing.
The direction that the left side of the disc is facing.
The direction that the top of the disc is facing.
An array representing the disk's velocity.
The number of times the disk has bounced. (TODO: Since the last time someone grabbed it? Do headbutts count as bounces?)
An object representing the current state of the local VR player. This is used for positions of the player within their playspace.
The direction that the left side of the player's head is facing within their playspace.
An array representing the player's position within their playspace.
The direction that the player's head is facing within their playspace.
The direction that the top side of the player's head is facing within their playspace.
An array of objects containing data used to instantiate the game's two teams. The first element in the array is always the blue team, while the second is always the orange team and the third is always the spectators.
A human-readable team name. Usually either "ORANGE TEAM" or "BLUE TEAM", but if all the players on a team have the same team name (set by pressing F11 while in a match or the lobby) it will be that instead.
Indicated whethe this team currently has possession of the disk.
An object containing data used to instantiate the team's current stats.
Points scored by the subject.
Time in seconds that the subject possessed the disk.
Number of times the subject intercepted a pass by the opposing team
API always returns zero for teams
Number of times the subject blocked a punch
API always returns zero for teams
Number of times the subject stole the disk from the opposing team
Number of times the subject successfully caught a pass by a team member
Number of times the subject successfully completed a pass
API always returns zero for teams
Number of opposing team goals prevented by the subject.
Number of goals scored by the subject.
API always returns zero for teams
Number of times the subject has stunned the opposing team.
Number of goals assisted by the subject.
Number of times the subject attempted a shot on goal
An array of objects containing data used to instantiate the team's players.
The username of the player.
A number representing ID of the player within the current game session.
A unique number identifying the player across all game sessions.
The number a player chose for themselves in the customization room.
Need to verify how this works in the new update.
A number (1-50) representing the player's experience "level". New accounts start as level 1, and will usually reach level 50 after a few hundred games in public matchmaking.
Note that there a rare bug where this number may be 0 in the UI in some cases; it's possible this bug may also affect the API (though this has yet to be verified).
Current ping (network latency to server) of this player.
Whether the player is currently stunned.
Whether or not the player is currently immune to stuns. Players will be in this state for 3 seconds after they are stunned.
Indicates whether this player currently has possession of the disk.
The item or object the player is holding in their left hand.
Possible values:
"disc"- player id (
"0","1") "geo"
The item or object the player is holding in their right hand.
Possible values:
"disc"- player id (
"0","1") "geo"
Whether the player is currently blocking (and will therefore deflect stuns).
An object containing data used to instantiate the player's current stats. See teams[].stats for a list of available stats.
The current velocity (speed and direction of movement) of the player.
An object containing position and rotation of the head of the player
The position of the player's head in the arena.
The direction that the player's head is facing.
The direction that the left side of the player's head is facing.
The direction that the top side of the player's head is facing.
An object containing position and rotation of the body of the player
The position of the player's body in the arena.
The direction that the player's body is facing.
The direction that the left side of the player's body is facing.
The direction that the top side of the player's body is facing.
An object containing position and rotation data for the right hand.
The position of the player's right hand within the arena.
The direction that the player's right hand is facing.
The direction that the left side of the player's right hand is facing.
The direction that the top side of the player's right hand is facing.
An object containing position and rotation data for the left hand.
The position of the player's left hand within the arena.
The direction that the player's left hand is facing.
The direction that the left side of the player's left hand is facing.
The direction that the top side of the player's left hand is facing.