Get leads

​

Endpoint

GET https://www.chatbase.co/api/v1/get-leads

​

Request Headers

• Authorization: Bearer <Your-Secret-Key> - The secret key for authenticating the API request.

​

Request Body Parameters

• chatbotId (string, required): The ID of the chatbot for which you want to retrieve leads.
• startDate (string): Represents the start date of the date range for fetching conversations. The date should be in “Year-Month-Day” format (e.g., 2023-07-10, not 2023-7-10).
• endDate (string): Represents the end date of the date range for fetching conversations. The date should be in “Year-Month-Day” format (e.g., 2023-07-13, not 2023-7-13).
• page (string): Specifies the page number of the results for pagination.
• size (string): Indicates the number of results per page, which is also used for pagination.

​

Example Requests

curl --request GET \
     --url 'https://www.chatbase.co/api/v1/get-leads?chatbotId=%5BYour%20Chatbot%20ID%5D&startDate=2023-01-01&endDate=2023-12-12&page=1&size=10' \
     --header 'accept: application/json'

const options = {method: 'GET', headers: {accept: 'application/json'}}

fetch(
  'https://www.chatbase.co/api/v1/get-leads?chatbotId=%5BYour%20Chatbot%20ID%5D&startDate=2023-01-01&endDate=2023-12-12&page=1&size=10',
  options
)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err))

import requests

url = "https://www.chatbase.co/api/v1/get-leads?chatbotId=%5BYour%20Chatbot%20ID%5D&startDate=2023-01-01&endDate=2023-12-12&page=1&size=10"

headers = {"accept": "application/json"}

response = requests.get(url, headers=headers)

print(response.text)

GET /api/v1/get-leads?chatbotId=%5BYour%20Chatbot%20ID%5D&startDate=2023-01-01&endDate=2023-12-12&page=1&size=10 HTTP/1.1
Accept: application/json
Host: www.chatbase.co

​

Responses

• 200: Returns an array collectedCustomers[] containing conversations that match the provided filters. These conversations represent leads generated by the chatbot.
• 400: If the start/end dates provided are invalid.
• 401: If the API request is unauthorized.
• 404: If the provided chatbot ID is invalid and does not correspond to any existing chatbot.
• 500: If there is an internal server error while processing the request.

​

Example Response

{
  "data": [
    {
      "id": 0,
      "created_at": "string",
      "chatbot_owner_user_id": "string",
      "chatbot_id": "string",
      "phone": "string",
      "email": "string",
      "name": "string"
    }
  ]
}