Endpoint
GET https://api.thred.dev/v1/customers?email=<email>
Authentication
Include your API key in the Authorization header:Authorization: Bearer YOUR_API_KEY
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | The customer’s email address |
Response
Processing Response
Returned while processing is still in progress:{
"status": "processing",
"name": "Sarah Johnson",
"email": "[email protected]",
"company": "TechCorp",
"platform": "chatgpt",
"progress": 25
}
Completed Response
Returned after processing completes:{
"status": "completed",
"name": "Sarah Johnson",
"email": "[email protected]",
"company": "TechCorp",
"platform": "chatgpt",
"productsDiscussed": ["Starter", "Pro"],
"insights": {
"mainConcerns": [],
"buyingSignals": [],
"competitorsConsidered": []
},
"suggestions": ["Prioritize ROI proof points"],
"summary": "Lead is evaluating integration depth and onboarding effort.",
"conversation": [
{
"role": "user",
"content": "How quickly can your team implement this?"
},
{
"role": "assistant",
"content": "We can usually launch in about two weeks."
}
],
"progress": 100,
"link": "https://app.thred.ai/share/<customerId>"
}
Error Responses
{
"error": "Bad request",
"message": "Email query parameter is required"
}
{
"error": "Bad request",
"message": "Invalid email format"
}
{
"error": "Not found",
"message": "Customer not found with this email"
}
{
"error": "Not found",
"message": "No chat data found for this customer"
}
Examples
curl -X GET "https://api.thred.dev/v1/[email protected]" \
-H "Authorization: Bearer YOUR_API_KEY"
const email = "[email protected]";
const response = await fetch(
`https://api.thred.dev/v1/customers?email=${encodeURIComponent(email)}`,
{
method: "GET",
headers: {
Authorization: "Bearer YOUR_API_KEY"
}
}
);
const data = await response.json();
console.log(data.status, data.summary);