Skip to content

Open app

Get session details

GET
/sessions/{session_id}

Retrieve metadata about a previously-created session.

Platform accounts must send the same sub_operator_ref they launched with - the session belongs to that brand, not to the platform identity, so reading it back without the selector resolves your default brand and answers 404.

Mobule requires current support approval for the exact organization bound to the authenticated operator key. Unbound keys cannot infer an organization. For a platform key, the approval of the platform’s organization covers its brands; a suspended or retired brand is refused. Discovery omits unapproved games (direct game/stakes lookup returns 404). Launches and launcher re-reads return PROVIDER_ACCESS_REQUIRED (403) on denial; storage uncertainty returns PROVIDER_ACCESS_UNAVAILABLE (503). Requests for other providers keep their existing access policy.

session_id
required
string format: uuid
sub_operator_ref
string
brand-01

Platform accounts only. The brand that owns this session - the same ref you sent on POST /v1/sessions. Omitting it resolves your platform’s default brand (404 unless the session belongs to that brand); sending it from a non-platform key is a 400 (E6006).

Same format and error codes as sub_operator_ref on POST /v1/sessions.

Session details.

object
session_id
required
string format: uuid
status
required
string
Allowed values: open closed expired
game_id
required
string format: uuid
provider_code
required
string
player_id
string
currency
string
country
string
created_at
required
string format: date-time
closed_at
string format: date-time
nullable

Missing, invalid, or revoked API key.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

Mobule access is not approved for the authenticated operator organization or session context.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

Session not found.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

Provider access or session authorization storage is temporarily unavailable.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any