---
title: "Get leads for a chatbot"
method: GET
path: "/get-leads"
tags: ["Leads"]
---

# Get leads for a chatbot

`GET /get-leads`

Retrieves collected leads/customers for a specific chatbot

## Query parameters

- `chatbotId` string, required
- `startDate` string, date
- `endDate` string, date
- `page` string
- `size` string

## Response `200`

Leads retrieved successfully

- object
  - `collectedCustomers` Lead[]
    - `id` string — Unique lead identifier
    - `name` string — Lead's name
    - `email` string, email — Lead's email address
    - `phone` string — Lead's phone number
    - `created_at` string, date-time — Lead collection timestamp
    - `chatbot_id` string — Associated chatbot ID
    - `account_id` string — Associated account ID

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist
- `500` — Internal Server Error

---

[API](https://skmtc.dev/chatbase/apis/chatbase-api-v1.md) · [All operations](https://skmtc.dev/chatbase/apis/chatbase-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chatbase/chatbase-api-v1/revisions/3a2187967746/schema)