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

# Retrieve Lead Events

`GET /v1/leads/events`

## Request

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

Returns all events associated with a specific session ID. Results can be optionally filtered by segment.

## Query parameters

- `sessionId` string, required
- `limit` integer, required
- `email` string
- `site` string, required
- `userId` integer
- `segmentId` integer

## 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)