> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessions

> List visitor sessions — each time someone viewed a room.

## Endpoints

| Method | Path               | Description   |
| ------ | ------------------ | ------------- |
| `GET`  | `/api/v2/sessions` | List sessions |

***

## List sessions

`GET /api/v2/sessions`

Returns visitor sessions across rooms in your organization, with location and timing information.

### Query parameters

<ParamField query="page" type="number">
  Page number (default: 1).
</ParamField>

<ParamField query="limit" type="number">
  Results per page (default: 10).
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.flowla.com/api/v2/sessions?page=1&limit=20" \
    -H "x-flowla-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.flowla.com/api/v2/sessions",
      headers={"x-flowla-api-key": "YOUR_API_KEY"},
      params={"page": 1, "limit": 20},
  )
  print(response.json())
  ```

  ```js JavaScript theme={null}
  const res = await fetch(
    "https://api.flowla.com/api/v2/sessions?page=1&limit=20",
    { headers: { "x-flowla-api-key": "YOUR_API_KEY" } }
  );
  const sessions = await res.json();
  ```
</CodeGroup>

### Response fields

| Field          | Type   | Description                       |
| -------------- | ------ | --------------------------------- |
| `flowId`       | string | Room identifier                   |
| `flowTitle`    | string | Room title                        |
| `sessionDate`  | string | ISO 8601 timestamp of the session |
| `visitorEmail` | string | Visitor's email address           |
| `visitorName`  | string | Visitor's name                    |
| `city`         | string | Visitor's city                    |
| `region`       | string | Visitor's region                  |
| `country`      | string | Visitor's country                 |