Find Lobbies
Find all the lobbies that match certain criteria.
Allowed entity token types: game_server, title_player_account
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| LobbyBadRequest | 13007 |
| LobbyRateLimitExceeded | 13001 |
Authorizations
This API requires an Entity Session Token, available from the Entity GetEntityToken method.
Body
Request to find lobbies.
Request to find lobbies.
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
OData style string that contains one or more filters. Only the following operators are supported: "and" (logical and), "eq" (equal), "ne" (not equals), "ge" (greater than or equal), "gt" (greater than), "le" (less than or equal), and "lt" (less than). The left-hand side of each OData logical expression should be either a search property key (e.g. string_key1, number_key3, etc) or one of the pre-defined search keys all of which must be prefixed by "lobby/": lobby/memberCount (number of players in a lobby), lobby/maxMemberCount (maximum number of players allowed in a lobby), lobby/memberCountRemaining (remaining number of players who can be allowed in a lobby), lobby/membershipLock (must equal 'Unlocked' or 'Locked'), lobby/amOwner (required to equal "true"), lobby/amMember (required to equal "true").
OData style string that contains sorting for this query in either ascending ("asc") or descending ("desc") order. OrderBy clauses are of the form "number_key1 asc" or the pre-defined search key "lobby/memberCount asc", "lobby/memberCountRemaining desc" and "lobby/maxMemberCount desc". To sort by closest, a moniker distance{number_key1 = 5} can be used to sort by distance from the given number. This field only supports either one sort clause or one distance clause.
Request pagination information.
