Campaigns
Copy
curl -X GET "https://api.foxreach.io/api/v1/leads?page=1&pageSize=20&search=acme" \
-H "X-API-Key: otr_your_key"
Copy
{
"data": [
{
"id": "cld_abc123",
"email": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"company": "Acme Inc",
"title": "VP of Sales",
"phone": "+1-555-0100",
"linkedinUrl": "https://linkedin.com/in/johndoe",
"website": "https://acme.com",
"customFields": { "industry": "SaaS" },
"notes": null,
"source": "csv_import",
"status": "active",
"lastContactedAt": null,
"createdAt": "2025-01-15T10:30:00",
"updatedAt": "2025-01-15T10:30:00"
}
],
"meta": {
"page": 1,
"pageSize": 20,
"total": 1,
"totalPages": 1
}
}
Leads
List Leads
Retrieve a paginated list of leads in your workspace.
GET
https://api.foxreach.io
/
api
/
v1
/
leads
Copy
curl -X GET "https://api.foxreach.io/api/v1/leads?page=1&pageSize=20&search=acme" \
-H "X-API-Key: otr_your_key"
Copy
{
"data": [
{
"id": "cld_abc123",
"email": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"company": "Acme Inc",
"title": "VP of Sales",
"phone": "+1-555-0100",
"linkedinUrl": "https://linkedin.com/in/johndoe",
"website": "https://acme.com",
"customFields": { "industry": "SaaS" },
"notes": null,
"source": "csv_import",
"status": "active",
"lastContactedAt": null,
"createdAt": "2025-01-15T10:30:00",
"updatedAt": "2025-01-15T10:30:00"
}
],
"meta": {
"page": 1,
"pageSize": 20,
"total": 1,
"totalPages": 1
}
}
Query Parameters
Page number (starts at 1).
Number of leads per page (1-100).
Search across email, first name, last name, and company.
Filter by lead status:
active, bounced, unsubscribed, or replied.Response
Array of lead objects.
Show Lead object
Show Lead object
Unique lead identifier.
Lead’s email address.
First name.
Last name.
Company name.
Job title.
Phone number.
LinkedIn profile URL.
Website URL.
Custom key-value fields.
Freeform notes.
How the lead was created (e.g.,
api, csv_import, manual).Lead status.
ISO 8601 timestamp.
ISO 8601 timestamp.
Copy
curl -X GET "https://api.foxreach.io/api/v1/leads?page=1&pageSize=20&search=acme" \
-H "X-API-Key: otr_your_key"
Copy
{
"data": [
{
"id": "cld_abc123",
"email": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"company": "Acme Inc",
"title": "VP of Sales",
"phone": "+1-555-0100",
"linkedinUrl": "https://linkedin.com/in/johndoe",
"website": "https://acme.com",
"customFields": { "industry": "SaaS" },
"notes": null,
"source": "csv_import",
"status": "active",
"lastContactedAt": null,
"createdAt": "2025-01-15T10:30:00",
"updatedAt": "2025-01-15T10:30:00"
}
],
"meta": {
"page": 1,
"pageSize": 20,
"total": 1,
"totalPages": 1
}
}
⌘I