> ## Documentation Index
> Fetch the complete documentation index at: https://www.thred.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Conversation by Customer ID

> Query a specific customer record and return transcript status and insight payloads.

## Endpoint

```bash theme={null}
GET https://api.thred.dev/v1/customers/:customerId
```

## Authentication

Include your API key in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## URL Parameters

| Parameter    | Type   | Required | Description                   |
| ------------ | ------ | -------- | ----------------------------- |
| `customerId` | string | Yes      | The 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

```json theme={null}
{
  "error": "Bad request",
  "message": "Invalid customerId format"
}
```

```json theme={null}
{
  "error": "Unauthorized",
  "message": "Workspace ID not found in request"
}
```

```json theme={null}
{
  "error": "Forbidden",
  "message": "You don't have access to this customer"
}
```

```json theme={null}
{
  "error": "Not found",
  "message": "Customer not found"
}
```

## Examples

```bash theme={null}
curl -X GET "https://api.thred.dev/v1/customers/k17f5j9m8k7j5n4m3k2j1h0g9f8e7d6c" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```javascript theme={null}
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);
```