# Match make with the Quick Join API

> Quickly match make players using Lobby's Quick Join.

Use the Lobby service to have a player randomly join any
session that's compatible with the parameters and filters passed to the `MatchmakeSessionAsync` method.

The following example demonstrates how to find and join a session in a single operation:

```cs
var quickJoinOptions = new QuickJoinOptions()
{
    Filters = new List<FilterOption>
    {
        new(FilterField.AvailableSlots, "1", FilterOperation.GreaterOrEqual),
        new (FilterField.StringIndex1, "map 1", FilterOperation.Equal)
    },
    Timeout = TimeSpan.FromSeconds(5),
    CreateSession = true
};

var sessionOptions = new SessionOptions()
{
    MaxPlayers = 2,
    Type = "Session",
}.WithRelayNetwork();

ISession session = await MultiplayerService.Instance.MatchmakeSessionAsync(quickJoinOptions, sessionOptions);
```

This code tries to join a session that has at least `1` available slot and the property `map 1`.
`MatchmakeSessionAsync` continues searching for a session until the set timeout of `5 seconds` is reached.

At this point, if the player can't join a session for any reason, such as all available sessions being full, the quick join operation can optionally create a new session using the `CreateSession` parameter.
Note that the new session is only created after the set timeout has expired, if set.

When the quick join operation finds or creates a session, it configures networking to use [Relay](/relay.md) connections.