---
title: "Retrieve Leads (CSV)"
method: GET
path: "/v1/leads/export"
tags: ["Leads"]
---

# Retrieve Leads (CSV)

`GET /v1/leads/export`

## Request

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

Exports a filtered list of leads as a CSV file for download.

## Query parameters

- `site` string, required
- `search` string
- `limit` integer
- `locale` string
- `nextToken` string
- `criteriaTextFilter` string
- `criteriaNumberFilter` string
- `criteriaTimeFilter` string
- `criteriaFieldFilter` string
- `criteriaExitLinkFilter` string
- `criteriaLeadscoreFilter` integer
- `criteriaDisplayFilter` string
- `timeField` 'eventEsTimestamp' | 'first_session_unix_timestamp', required
- `usePresetExclusionList` 'use_id' | 'last_most_likely_company' | 'organizationName' | 'organizationDomain'
- `dateFormat` string
- `userId` integer
- `separator` string
- `timeZone` string
- `sortBy` string
- `additionalCsvFields` string

## Response `200`

CSV file generated successfully

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