Get session details

GET

/sessions/{session_id}

• Production

Retrieve metadata about a previously-created session.

Authorizations

• bearerAuth

Parameters

Path Parameters

session_id

required

string format: uuid

Query Parameters

sub_operator_ref

string

brand-01

Platform accounts only. Which brand this call acts as — the same ref the session or grant was created with. Same format and error codes as sub_operator_ref on POST /v1/sessions: omit it to use your default brand, and note that sending it empty is a 400 (E6004), not a fallback.

Responses

200

Session details.

object

session_id

required

string format: uuid

status

required

string

Allowed values: open closed expired

game_id

required

The Aggregator catalog game UUID (matches Game.id).

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

401

Missing, invalid, or revoked API key.

object

error

required

object

code

required

Machine-parseable error code. See https://docs.aggregator.gg/resources/error-codes/.

string

/^E[0-9A-F][0-9]{3}$/

E0001

type

Snake-case mnemonic for the code (e.g. game_blocked_jurisdiction, player_self_excluded). Branch on code; type is for readability.

string

game_blocked_jurisdiction

message

required

string

request_id

Correlation ID for support escalation.

string

details

object

key

additional properties

any

404

Session not found.

object

error

required

object

code

required

Machine-parseable error code. See https://docs.aggregator.gg/resources/error-codes/.

string

/^E[0-9A-F][0-9]{3}$/

E0001

type

Snake-case mnemonic for the code (e.g. game_blocked_jurisdiction, player_self_excluded). Branch on code; type is for readability.

string

game_blocked_jurisdiction

message

required

string

request_id

Correlation ID for support escalation.

string

details

object

key

additional properties

any