Skip to main content
GET
/
v1
/
lead-database
/
searches
/
{id}
/
status
curl -X GET "https://api.sendpilot.ai/v1/lead-database/searches/search_abc123xyz/status" \
  -H "X-API-Key: your-api-key"

{
  "id": "search_abc123xyz",
  "name": "Tech Founders Q1 2024",
  "status": "processing",
  "progress": {
    "requested": 100,
    "found": 45,
    "percent_complete": 45
  },
  "created_at": "2024-02-24T10:30:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sendpilot.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns the current status and progress of a lead database search.

​
Request

​
X-API-Key
string
required
Your API key

​
Path Parameters

​
id
string
required
The search ID returned from the create search endpoint

​
Response

​
id
string
Unique identifier for the search
​
name
string
Name of the search
​
status
string
Current status: pending, processing, completed, failed
​
progress
object
​
created_at
string
ISO 8601 timestamp when the search was created
curl -X GET "https://api.sendpilot.ai/v1/lead-database/searches/search_abc123xyz/status" \
  -H "X-API-Key: your-api-key"

{
  "id": "search_abc123xyz",
  "name": "Tech Founders Q1 2024",
  "status": "processing",
  "progress": {
    "requested": 100,
    "found": 45,
    "percent_complete": 45
  },
  "created_at": "2024-02-24T10:30:00.000Z"
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Path Parameters

​
id
string
required

Search ID

Response

Search status

​
id
string
required

Unique identifier for the search

​
name
string
required

Name of the search

​
status
enum<string>
required

Current status of the search

Available options:
pending,
processing,
completed,
failed
​
created_at
string<date-time>
required

ISO 8601 timestamp when the search was created

​
totalResults
integer

Total number of leads found (available when completed)

​
progress
integer

Progress percentage (0-100)

​
completed_at
string<date-time>

ISO 8601 timestamp when the search completed