Account Research
List Account Research Reports
Every account research report of your workspace
GET
/
v2
/
abs_reports
curl https://api.clustr-ai.com/v2/abs_reports \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"reports": [
{
"id": "ac149745-bb7c-40ef-a799-e9e7488dc50e",
"job_id": "fae8ac62-87d2-4680-a223-9a571db8538b",
"target_company_name": "Northwind Logistics",
"target_company_linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"target_company_numeric_id": "18472301",
"target_company_industry": "Transportation & Logistics",
"target_company_employee_count": 320,
"search_params": {
"company_linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"company_name": "Northwind Logistics",
"location_filter": "France",
"company_url": "https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy",
"country": "France",
"job_titles": [
"VP Sales"
]
},
"employees_searched": 320,
"employees_processed": 320,
"intros_discovered": 12,
"unique_contacts": 12,
"avg_confidence_score": 0.82,
"report_data": {
"job_id": "fae8ac62-87d2-4680-a223-9a571db8538b",
"company": {
"name": "Northwind Logistics",
"linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"numeric_id": "2ed206b6-9fe9-4fb0-a190-7bed61ccd11a",
"industry": "Transportation & Logistics",
"employee_count": 320
},
"search_params": {
"company_linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"company_name": "Northwind Logistics",
"location_filter": "France",
"company_url": "https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy",
"country": "France",
"job_titles": [
"VP Sales"
]
},
"employees_searched": 320,
"employees_processed": 320,
"paths_discovered": 12,
"unique_contacts": 12,
"avg_confidence_score": 0.82,
"executive_summary": "Northwind Logistics is renewing its fleet software in Q1; two connectors know the buyer.",
"employees": [
{
"linkedin_id": "thomas-lefevre-4b2a1",
"name": "Thomas Lefevre",
"title": "Head of Procurement",
"headline": "Head of Procurement at Northwind Logistics",
"profile_url": "https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy",
"location": "Lyon, France",
"intro_paths": [
{
"contact_linkedin_id": "thomas-lefevre-4b2a1",
"contact_name": "Thomas Lefevre",
"path_type": "colleague",
"shared_company": "Acme Analytics",
"overlap_months": 18,
"confidence_score": 0.82,
"engagement_count": 3,
"contact_job_title": "Thomas Lefevre",
"employee_job_title": "Director of Engineering",
"contact_location": "Lyon, France",
"employee_location": "Lyon, France",
"overlap_start_ym": 12,
"overlap_end_ym": 12,
"is_current_overlap": true,
"same_location": true,
"company_linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"has_recommendation": true,
"location_match_type": "city"
}
],
"validated": true,
"prospect_count": 3
}
],
"generated_at": "2026-10-28T16:02:05Z",
"path_enrichments": {
"enrichments_1": {
"tier": "Tier 1",
"reason": "On your target list",
"enriched_at": "2026-09-30T12:00:00Z",
"retry_count": 3
}
}
},
"executive_summary": "Northwind Logistics is renewing its fleet software in Q1; two connectors know the buyer.",
"status": "active",
"created_at": "2026-11-03T09:14:22Z",
"completed_at": "2026-11-03T09:14:22Z",
"warm_buyer_count": 3,
"cold_buyer_count": 3,
"warm_buyers": 12,
"cold_buyers": 12,
"clustr_account_research_id": "abs_45b7erb6y82qzjdkahw00m1695",
"clustr_job_id": "job_6jwhwv3wycsebzfq0fxnw7gpbb",
"clustr_target_account_id": "tacc_7490xf0kzqpzqpvv870g97bvyz",
"clustr_workspace_id": "ten_5qjvdvcsf461e94cymeffggcdg"
}
],
"total": 128
}
}{
"success": true,
"error": {
"code": "ADMIN_REQUIRED",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
}{
"success": true,
"error": {
"code": "ADMIN_REQUIRED",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
}{
"success": true,
"error": {
"code": "ADMIN_REQUIRED",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
}Every account research report of your workspace, newest first, whether it was started in the
app, through the API or by the assistant. Reading reports is free; only
Start Account Research spends a credit.
Each report carries its
id, the abs_report_id the other report operations take, and the
job_id of the run that wrote it, the one Start Account Research answered. Find a report you
started by that job_id.
| Field | Meaning |
|---|---|
target_company_name, target_company_linkedin_url | The company researched |
status | Where the report stands |
warm_buyer_count | Buyers at the company with at least one warm path |
cold_buyer_count | Buyers with none |
intros_discovered | Warm paths found, across every buyer |
created_at, completed_at | When the run started and when it wrote the report |
curl https://api.clustr-ai.com/v2/abs_reports \
-H "Authorization: Bearer YOUR_API_KEY"
⌘I
curl https://api.clustr-ai.com/v2/abs_reports \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"reports": [
{
"id": "ac149745-bb7c-40ef-a799-e9e7488dc50e",
"job_id": "fae8ac62-87d2-4680-a223-9a571db8538b",
"target_company_name": "Northwind Logistics",
"target_company_linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"target_company_numeric_id": "18472301",
"target_company_industry": "Transportation & Logistics",
"target_company_employee_count": 320,
"search_params": {
"company_linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"company_name": "Northwind Logistics",
"location_filter": "France",
"company_url": "https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy",
"country": "France",
"job_titles": [
"VP Sales"
]
},
"employees_searched": 320,
"employees_processed": 320,
"intros_discovered": 12,
"unique_contacts": 12,
"avg_confidence_score": 0.82,
"report_data": {
"job_id": "fae8ac62-87d2-4680-a223-9a571db8538b",
"company": {
"name": "Northwind Logistics",
"linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"numeric_id": "2ed206b6-9fe9-4fb0-a190-7bed61ccd11a",
"industry": "Transportation & Logistics",
"employee_count": 320
},
"search_params": {
"company_linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"company_name": "Northwind Logistics",
"location_filter": "France",
"company_url": "https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy",
"country": "France",
"job_titles": [
"VP Sales"
]
},
"employees_searched": 320,
"employees_processed": 320,
"paths_discovered": 12,
"unique_contacts": 12,
"avg_confidence_score": 0.82,
"executive_summary": "Northwind Logistics is renewing its fleet software in Q1; two connectors know the buyer.",
"employees": [
{
"linkedin_id": "thomas-lefevre-4b2a1",
"name": "Thomas Lefevre",
"title": "Head of Procurement",
"headline": "Head of Procurement at Northwind Logistics",
"profile_url": "https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy",
"location": "Lyon, France",
"intro_paths": [
{
"contact_linkedin_id": "thomas-lefevre-4b2a1",
"contact_name": "Thomas Lefevre",
"path_type": "colleague",
"shared_company": "Acme Analytics",
"overlap_months": 18,
"confidence_score": 0.82,
"engagement_count": 3,
"contact_job_title": "Thomas Lefevre",
"employee_job_title": "Director of Engineering",
"contact_location": "Lyon, France",
"employee_location": "Lyon, France",
"overlap_start_ym": 12,
"overlap_end_ym": 12,
"is_current_overlap": true,
"same_location": true,
"company_linkedin_url": "https://www.linkedin.com/company/northwind-logistics",
"has_recommendation": true,
"location_match_type": "city"
}
],
"validated": true,
"prospect_count": 3
}
],
"generated_at": "2026-10-28T16:02:05Z",
"path_enrichments": {
"enrichments_1": {
"tier": "Tier 1",
"reason": "On your target list",
"enriched_at": "2026-09-30T12:00:00Z",
"retry_count": 3
}
}
},
"executive_summary": "Northwind Logistics is renewing its fleet software in Q1; two connectors know the buyer.",
"status": "active",
"created_at": "2026-11-03T09:14:22Z",
"completed_at": "2026-11-03T09:14:22Z",
"warm_buyer_count": 3,
"cold_buyer_count": 3,
"warm_buyers": 12,
"cold_buyers": 12,
"clustr_account_research_id": "abs_45b7erb6y82qzjdkahw00m1695",
"clustr_job_id": "job_6jwhwv3wycsebzfq0fxnw7gpbb",
"clustr_target_account_id": "tacc_7490xf0kzqpzqpvv870g97bvyz",
"clustr_workspace_id": "ten_5qjvdvcsf461e94cymeffggcdg"
}
],
"total": 128
}
}{
"success": true,
"error": {
"code": "ADMIN_REQUIRED",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
}{
"success": true,
"error": {
"code": "ADMIN_REQUIRED",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
}{
"success": true,
"error": {
"code": "ADMIN_REQUIRED",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
}