Skip to main content
GET
/
api
/
leads
/
search
Get Search Task
curl --request GET \
  --url https://app.puffle.ai/api/leads/search \
  --header 'Authorization: Bearer <token>'
{
  "tasks": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "lead_search",
      "status": "<string>",
      "statusUrl": "<string>",
      "resultListId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "prompt": "<string>",
      "title": "<string>",
      "filters": {},
      "resultCount": 4503599627370495,
      "errorMessage": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "completedAt": "2023-11-07T05:31:56Z"
    }
  ]
}
CLI: 
puffle lead search
puffle lead search --task-id <task-id>

​
Overview

Returns recent Searches owned by the authenticated user. Pass taskId to fetch one search’s current status. Intended for UI history, polling, and agent memory; use the results endpoint to page through result rows.
This operation shares the URL path /api/leads/search with other verbs. Use Start lead search to create or continue a search, then call this endpoint with taskId to poll it.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
taskId
string<uuid>

Response

Up to 20 most-recent tasks, or one task when taskId is provided.

Recent lead search tasks.

​
tasks
object[]
required