---
title: "Export leads."
method: GET
path: "/api/v1/projects/{projectId}/reports/leads"
tags: ["Reports & Analytics"]
---

# Export leads.

`GET /api/v1/projects/{projectId}/reports/leads`

## Request

- Base URL: `https://app.customgpt.ai`
- URL: `https://app.customgpt.ai/api/v1/projects/{projectId}/reports/leads`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/poll-the-people/apis/customgpt-ai/docs/api/v1/projects/:projectId/reports/leads/get.ts> (a function with typed inputs; its response is checked against the schema)

Exports lead information captured from conversations, including email addresses, names, and any custom fields collected. Use this to sync leads with your CRM or marketing tools.

## Path parameters

- `projectId` integer, required

## Query parameters

- `start_date` string, date-time
- `end_date` string, date-time
- `page` integer
- `limit` integer
- `session_id` string

## Response `200`

Project leads export data

- object
  - `status` 'error' | 'success': The status of the response
  - `data` object
    - `current_page` integer: The page number of this response. The first page is 1.
    - `data` ProjectLeadsExport[]
      - `project_id` integer: The project ID
      - `session_id` string, uuid: The Conversation Session ID
      - `query_id` integer: The query ID
      - `name` string, nullable: Lead name
      - `email` string, nullable: Lead email
      - `phone_number` string, nullable: Lead phone number
      - `company` string, nullable: Lead company
      - `captured_at` string, date-time: When the lead was captured
      - `other_data` object, nullable: Additional lead data
      - `user_defined` object, nullable: User-defined lead data
      - `tags` string[], nullable: Lead tags
    - `first_page_url` string: The first page url
    - `from` integer: The first item number of the current page
    - `last_page` integer: Total number of pages available. Pagination is complete when the requested `page` equals `last_page`.
    - `last_page_url` string: The last page url
    - `next_page_url` string: The next page url
    - `path` string: The current page url
    - `per_page` integer: Number of results returned per page.
    - `prev_page_url` string: The previous page url
    - `to` integer: The last item number of the current page
    - `total` integer: The total number of items

## Other responses

- `400`: Bad Argument
- `401`: API Token is either missing or invalid
- `404`: Agent not found
- `429`: Too many requests. You have exceeded your API rate limit.
- `500`: Internal Server Error

## Changes

- **2026-11-03** `77aab4354382`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/poll-the-people/apis/customgpt-ai/changes/api/v1/projects/:projectId/reports/leads/get.md)

---

[API](https://skmtc.dev/poll-the-people/apis/customgpt-ai.md) - [All operations](https://skmtc.dev/poll-the-people/apis/customgpt-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/poll-the-people/apis/customgpt-ai/revisions/77aab4354382?raw)