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

List leads

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

Access is gated — enable it before your first call

The API is off by default. A request succeeds only when all three switches are on: the platform master switch (off by default), your organisation’s API toggle, and your plan or client entitlement. Any one off returns 403 API access is not enabled for this workspace.

Parameters

Name	In	Type	Required	Default	Description
limit	query	integer	Optional	100	Maximum number of items to return. Defaults to 100; values above 200 are clamped to 200.
cursor	query	string	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 body = 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
  }
}