---
title: "Retrieve Lead Sessions"
method: GET
path: "/v1/leads/sessions"
tags: ["Leads"]
---

# Retrieve Lead Sessions

`GET /v1/leads/sessions`

## Request

- Base URL: `https://api.leadboxer.com`
- URL: `https://api.leadboxer.com/v1/leads/sessions`
- Auth: API key in header `x-api-key`

Returns all sessions associated with a specific lead ID. Results can be filtered by segment and time range.

## Query parameters

- `leadId` string, required
- `limit` integer, required
- `site` string, required
- `email` string
- `userId` integer
- `segmentId` integer
- `minTime` integer
- `nextToken` string

## Response `200`

OK

- GetAllResponseMapStringObject
  - `data` object[]
  - `metaData` object

## Other responses

- `400`: Bad Request: The request is invalid or malformed (missing/incorrect parameters).
- `402`: Payment Required: The client has exceeded credit limits.
- `403`: Forbidden: The authenticated user does not have permission to access this resource.
- `404`: Not Found: The requested resource does not exist.
- `409`: Conflict: The request could not be completed due to a resource state conflict.
- `429`: Too Many Requests: Rate limit exceeded. The client has sent too many requests in a given time period
- `500`: Interval Server Error: An unexpected error occurred on the server.

---

[API](https://skmtc.dev/leadboxer/apis/leadboxer-api.md) · [All operations](https://skmtc.dev/leadboxer/apis/leadboxer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leadboxer/apis/leadboxer-api/revisions/34249b480395?raw)