Skip to main content

Endpoint

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

Authentication

Authorization: Bearer YOUR_API_KEY

Query Parameters

All filters are optional.
ParameterTypeDescription
limitnumberPositive integer max result count
platformsstringComma-separated values from: chatgpt, gemini, pplx, claude
startDatenumberStart timestamp (Unix milliseconds)
endDatenumberEnd timestamp (Unix milliseconds)

Response

Returns an array of conversation objects in the same schema as email/ID lookup:
[
  {
    "status": "completed",
    "name": "Sarah Johnson",
    "email": "[email protected]",
    "company": "TechCorp",
    "platform": "chatgpt",
    "summary": "Lead is comparing migration complexity between vendors.",
    "conversation": [
      {
        "role": "user",
        "content": "What would migration effort look like?"
      },
      {
        "role": "assistant",
        "content": "We need low-risk rollout and strong implementation support."
      }
    ],
    "progress": 100,
    "link": "https://app.thred.ai/share/<customerId>"
  }
]

Error Responses

{
  "error": "Bad request",
  "message": "Limit must be a positive integer"
}
{
  "error": "Bad request",
  "message": "Invalid platform(s): foo. Must be one of: chatgpt, gemini, pplx, claude"
}
{
  "error": "Bad request",
  "message": "startDate must be a valid unix timestamp (milliseconds)"
}
{
  "error": "Bad request",
  "message": "endDate must be a valid unix timestamp (milliseconds)"
}
{
  "error": "Not found",
  "message": "No customers found"
}

Examples

curl -X GET "https://api.thred.dev/v1/customers/recent?limit=20&platforms=chatgpt,gemini" \
  -H "Authorization: Bearer YOUR_API_KEY"
const params = new URLSearchParams({
  limit: "20",
  platforms: "chatgpt,claude",
  startDate: String(Date.now() - 7 * 24 * 60 * 60 * 1000)
});

const response = await fetch(
  `https://api.thred.dev/v1/customers/recent?${params.toString()}`,
  {
    headers: { Authorization: "Bearer YOUR_API_KEY" }
  }
);

const data = await response.json();
console.log(data.length);