GEThttps://app.evoriqa.com/api/v1/leads

List leads in the workspace

Returns the workspace's leads, newest first, cursor-paginated. Each lead includes its assigned owner, or null when unassigned.

Requires scope leads:read

Available on every plan

Create a key under Settings → API keys and call it. If you’re a client of an agency or reseller and get 403 API access is not enabled for this workspace., your provider turns the API on for your workspace.

Parameters

Name	In	Type	Required	Default	Description
limit	query	integer 1–200	Optional	100	Maximum number of items to return. Defaults to 100; values above 200 are clamped to 200.
cursor	query	string uuid	Optional	—	The `nextCursor` from the previous page. A malformed cursor is ignored and the first page is returned.

Request

curl

curl "https://app.evoriqa.com/api/v1/leads" \
  -H "x-api-key: $EVORIQA_API_KEY"

Node.js

const res = await fetch("https://app.evoriqa.com/api/v1/leads", {
  headers: {
    Authorization: `Bearer ${process.env.EVORIQA_API_KEY}`,
  },
});

const responseBody = await res.json();

Python

import os
import requests

res = requests.get(
    "https://app.evoriqa.com/api/v1/leads",
    headers={"Authorization": f"Bearer {os.environ['EVORIQA_API_KEY']}"},
)

body = res.json()

Response

200 OK

{
  "success": true,
  "data": {
    "data": [
      {
        "id": "b7d2f1c0-3a4e-4c88-9f21-2e7a6c0d1b34",
        "chatbotId": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
        "name": "Dana Reyes",
        "email": "dana@example.com",
        "phone": "+1-555-0142",
        "company": "Northwind Labs",
        "status": "new",
        "createdAt": "2026-01-17T11:47:00.000Z",
        "owner": {
          "id": "a10c33d4-9e58-4b2a-8c7f-1d5e2f3a4b6c",
          "name": "Sam Carter",
          "email": "sam@acme.com"
        }
      }
    ],
    "nextCursor": null
  }
}