Overview
Submit a prospect’s email address to start an enrichment job.
Returns immediately with a research_id — enrichment runs asynchronously in the background.
Poll GET /research-status/{research_id} until status is completed.
Base URL: https://rpiqzfzokrwxavztrpmp.supabase.co/functions/v1
Request
POST /research
Authorization: Bearer cp_live_...
Content-Type: application/json
Body parameters
| Parameter | Type | Required | Description |
|---|
email | string | ✅ | Prospect’s work email address |
prospect_name | string | ❌ | Full name — improves match accuracy |
company_name | string | ❌ | Company name — improves match accuracy |
linkedin_url | string | ❌ | Prospect’s LinkedIn profile URL |
company_linkedin_url | string | ❌ | Company LinkedIn URL — overrides auto-detected |
Minimal request
curl -X POST \
https://rpiqzfzokrwxavztrpmp.supabase.co/functions/v1/research \
-H "Authorization: Bearer cp_live_..." \
-H "Content-Type: application/json" \
-d '{ "email": "sarah.mitchell@acmecorp.com" }'
Full request
curl -X POST \
https://rpiqzfzokrwxavztrpmp.supabase.co/functions/v1/research \
-H "Authorization: Bearer cp_live_..." \
-H "Content-Type: application/json" \
-d '{
"email": "sarah.mitchell@acmecorp.com",
"prospect_name": "Sarah Mitchell",
"company_name": "Acme Corp",
"linkedin_url": "https://www.linkedin.com/in/sarah-mitchell/",
"company_linkedin_url": "https://www.linkedin.com/company/acmecorp/"
}'
Response
HTTP 202 — Accepted
{
"research_id": "res_1a7b6e9c35a9b848",
"status": "processing",
"estimated_seconds": 30
}
| Field | Description |
|---|
research_id | Unique ID for this job — use it to poll for results |
status | Always processing on initial response |
estimated_seconds | Estimated completion time in seconds |
Error responses
401 — Missing or invalid API key
{ "error": "missing_api_key" }
{ "error": "invalid_key" }
{ "error": "missing_email" }
{ "error": "invalid_email_format" }
{
"error": "credits_exhausted",
"used": 50,
"limit": 50
}
Notes
Providing prospect_name and company_name improves match accuracy
and is recommended whenever you have that information available.
