> For the complete documentation index, see [llms.txt](https://docs.digitalsamba.com/reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalsamba.com/reference/rest-api/statistics/started-sessions.md).

# Started sessions

To see how many sessions each unique participant (tracked by browser uuid) has started -> execute a **GET** request against **/statistics/participants/started-sessions.**

{% hint style="info" %}
You can page through the records with limit and offset params.

api/v1/statistics/participants/started-sessions?**limit**=100&**offset**=200
{% endhint %}

{% hint style="info" %}
You can also choose a custom period with the **date\_start** and **date\_end** query params.

api/v1/statistics/participants/started-sessions?**date\_start**=2025-08-01&**date\_end**=2025-08-31\&limit=100\&offset=200
{% endhint %}

#### Request

{% tabs %}
{% tab title="cURL" %}
{% code overflow="wrap" %}

```bash
curl --request GET \
  --url https://api.digitalsamba.com/api/v1/statistics/participants/started-sessions \
  --user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY
```

{% endcode %}
{% endtab %}

{% tab title="Java" %}

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.util.Base64;
import java.util.Map;

String TEAM_ID = "YOUR_TEAM_ID";
String DEVELOPER_KEY = "YOUR_DEVELOPER_KEY";
String authorizationHeader = "Bearer " + Base64.getEncoder().encodeToString((TEAM_ID + ":" + DEVELOPER_KEY).getBytes());

HttpRequest request = HttpRequest.newBuilder()
  .GET()
  .uri(new URI("https://api.digitalsamba.com/api/v1/statistics/participants/started-sessions"))
  .header("Authorization", authorizationHeader)
  .build();

HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());

System.out.println("Status code: " + response.statusCode());
System.out.println("Body: " + response.body());
```

{% endtab %}
{% endtabs %}

#### Response (200 OK)

```json
{
    "total_count": 545,
    "data": [
        {
            "browser_id": "57f516f8-6ca4-4fda-a528-7b86a4a9fc4d",
            "sessions_started": 2088
        },
        ...............
    ]
}
```

{% hint style="info" %}
The **total\_count** is the total amount of unique participants that started a session. It is **NOT** the amount of participants in the current page returned in the **data** array. In the above example you have 545 participants in total, but in the data array there will be maximum 100 participants (the default limit argument value).
{% endhint %}
