> ## 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 Conversations by Company

> Return matched customer conversations and summaries for a target company.

## Endpoint

```bash theme={null}
GET https://api.thred.dev/v1/customers/by-company?name=<company_name>
```

## Authentication

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

## Query Parameters

| Parameter | Type   | Required | Description           |
| --------- | ------ | -------- | --------------------- |
| `name`    | string | Yes      | Company name to match |

## Response

```json theme={null}
{
  "company": "TechCorp",
  "results": [
    {
      "status": "completed",
      "name": "Sarah Johnson",
      "email": "sarah@example.com",
      "company": "TechCorp",
      "platform": "chatgpt",
      "summary": "Lead is evaluating onboarding and security requirements.",
      "conversation": [
        {
          "role": "user",
          "content": "What security controls matter most to you?"
        },
        {
          "role": "assistant",
          "content": "SOC 2 and SSO are must-haves for us."
        }
      ],
      "progress": 100,
      "link": "https://app.thred.ai/share/<customerId>"
    }
  ]
}
```

## Error Responses

```json theme={null}
{
  "error": "Bad request",
  "message": "Company name query parameter 'name' is required"
}
```

```json theme={null}
{
  "error": "Not found",
  "message": "No customers found matching this company name"
}
```

## Example

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