Skip to main content

​
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

ParameterTypeRequiredDescription
emailstringYesThe 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);