Buying Committee
Return a buying committee tagged by role: decision maker, influencer, budget owner.
Endpoint
POST /api/v1/contacts/buying-committeeAuthentication
All requests require the X-Satellyte-API-Key header. See Quickstart.
Request body
| Field | Type | Required | Notes |
|---|---|---|---|
company_domain | string | Yes | Company domain. |
roles | string[] | No | Defaults to ["decision_maker", "influencer", "budget_owner"]. |
cURL
curl -i -X POST "https://api-staging.satellyte.ai/api/v1/contacts/buying-committee" \
-H "X-Satellyte-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"company_domain": "openai.com",
"roles": ["decision_maker", "influencer", "budget_owner"]
}'Response (200)
{
"data": [
{
"id": "lead_123",
"name": "Jane Doe",
"title": "Head of Sales",
"role": "decision_maker",
"linkedin_url": "https://www.linkedin.com/in/janedoe/",
"outreach_angle": "Mention recent hiring/funding signal."
}
]
}Response fields
| Field | Type | Notes |
|---|---|---|
data | array | Buying committee contacts tagged by role. |
data[].id | string | Lead or contact identifier. |
data[].name | string | Contact full name. |
data[].title | string | Contact job title. |
data[].role | string | Buying committee role, such as decision_maker, influencer, or budget_owner. |
data[].linkedin_url | string | LinkedIn profile URL when known. |
data[].outreach_angle | string | Suggested outreach angle for the contact. |
Error responses
All failed calls use the standard error envelope documented in Errors.
| Status | Code | Notes |
|---|---|---|
400 | validation_error | Returned when the request body is invalid or the company identifier is missing or invalid. |
401 | unauthorized | Returned when X-Satellyte-API-Key is missing, invalid, or expired. |
404 | not_found | Returned when Public API access is not enabled or the requested Public API resource is unavailable. |
429 | rate_limit_exceeded | Returned when the API key exceeds its configured rate limit. |
500 | service_error | Returned when the service cannot complete the request. Retry with backoff. |