Skip to main content
GET
/
api
/
leads
/
search
/
results
Get Search Result
curl --request GET \
  --url https://app.puffle.ai/api/leads/search/results \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {}
  ],
  "total": 4503599627370495,
  "limit": 4503599627370495,
  "offset": 4503599627370495,
  "hasMore": true
}
CLI: 
puffle lead search result --task-id <task-id>
puffle lead search result --task-id <task-id> --offset <offset> --limit <limit>

​
Overview

Returns paginated results for a Search. Results are saved rows from the asynchronous search process while the result List is populated. Call this after Start lead search returns a task and GET /api/leads/search?taskId={taskId} shows progress or completion.

​
AI agent notes

Pass taskId, plus optional offset and limit. The maximum page size is 500.This endpoint accepts taskId values returned by /api/leads/search. Do not pass older search IDs.Use these results for review and sampling. List population is owned by Start lead search: pass listId to populate an existing list, or omit it to create a new result list.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
taskId
string<uuid>
required
​
offset
integer
default:0
Required range: 0 <= x <= 9007199254740991
​
limit
integer
default:50
Required range: 0 < x <= 500

Response

Paginated search results.

​
results
object[]
required
​
total
integer
required
Required range: 0 <= x <= 9007199254740991
​
limit
integer
required
Required range: 0 < x <= 9007199254740991
​
offset
integer
required
Required range: 0 <= x <= 9007199254740991
​
hasMore
boolean
required