List Leads

Get a paginated list of captured leads, optionally filtered by source channel.

GET /v1/leads

Parameters

Parameter	Type	Default	Description
from	ISO 8601	30 days ago	Start of the date range
to	ISO 8601	Now	End of the date range
source	string	—	Filter by source: chat, voice, whatsapp, messenger, instagram
cursor	string	—	Pagination cursor
limit	integer	25	Items per page (max: 100)

Response

{
  "data": [
    {
      "id": "880e8400-e29b-41d4-a716-446655440000",
      "email": "[e-mail]",
      "name": "John Doe",
      "phone": "[phone]",
      "source": "chat",
      "created_at": "2026-03-10T09:20:00.000Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  }
}

Response Fields

Field	Type	Description
id	string	Lead ID
email	string|null	Guest email address
name	string|null	Guest name
phone	string|null	Guest phone number
source	string	Channel where the lead was captured
created_at	string	When the lead was captured

Example

cURL

# All leads from the last 7 days
curl "https://api.opally.com/v1/leads?from=2026-03-05&limit=50" \
  -H "Authorization: Bearer op_live_your_api_key_here"

# Only chat leads
curl "https://api.opally.com/v1/leads?source=chat" \
  -H "Authorization: Bearer op_live_your_api_key_here"

JavaScript