Sessions

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, device, and contact information.

Query parameters

number

Page number (default: 1).

number

Results per page (default: 10).

string

Filter sessions to a specific room.

string

Filter by identified contact ID.

string

Search by visitor name or email.

boolean

When true, return only sessions with an identified contact.

"createdAt" | "updatedAt"

Sort field (default: createdAt).

"ASC" | "DESC"

Sort direction (default: DESC).

string

Return sessions created at or after this ISO 8601 date.

string

Return sessions created at or before this ISO 8601 date.

Response fields

Each item in results includes:

Field	Type	Description
`id`	string	Session identifier
`roomId`	string	Room the session belongs to
`createdAt`	string	ISO 8601 — when the session started
`updatedAt`	string	ISO 8601
`city`	string \| null	Visitor city
`region`	string \| null	Visitor region
`country`	string \| null	Visitor country
`visitorNumber`	number \| null	Ordinal visitor number for this room
`browser.software`	string \| null	Browser name
`browser.os`	string \| null	Operating system
`browser.contact`	object \| null	Identified contact (`id`, `email`, `fullName`)
`user`	object \| null	Room owner (`id`, `email`, `firstName`, `lastName`)

curl "https://api.flowla.com/api/v2/sessions?roomId=<room_id>&limit=20" \
  -H "x-flowla-api-key: YOUR_API_KEY"

import requests

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

const res = await fetch(
  "https://api.flowla.com/api/v2/sessions?roomId=<room_id>&limit=20",
  { headers: { "x-flowla-api-key": "YOUR_API_KEY" } }
);
const data = await res.json();

Getting started

Rooms

Structure

Action Items

Automation

Lookups

Endpoints

List sessions

Query parameters

Response fields

​Endpoints

​List sessions

​Query parameters

​Response fields

Endpoints

List sessions

Query parameters

Response fields