Skip to main content

Endpoint

GET https://api.thred.dev/v1/customers/:customerId

Authentication

Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY

URL Parameters

ParameterTypeRequiredDescription
customerIdstringYesThe target customer record ID

Response

Response shape matches the email lookup endpoint:
  • Processing: status, name, email, company, platform, progress
  • Completed: includes summary, conversation, insights, suggestions, and link

Error Responses

{
  "error": "Bad request",
  "message": "Invalid customerId format"
}
{
  "error": "Unauthorized",
  "message": "Workspace ID not found in request"
}
{
  "error": "Forbidden",
  "message": "You don't have access to this customer"
}
{
  "error": "Not found",
  "message": "Customer not found"
}

Examples

curl -X GET "https://api.thred.dev/v1/customers/k17f5j9m8k7j5n4m3k2j1h0g9f8e7d6c" \
  -H "Authorization: Bearer YOUR_API_KEY"
const customerId = "k17f5j9m8k7j5n4m3k2j1h0g9f8e7d6c";

const response = await fetch(`https://api.thred.dev/v1/customers/${customerId}`, {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_KEY"
  }
});

const data = await response.json();
console.log(data.status, data.summary);