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

# List Replies

> Retrieve a list of replies in your workspace

Fetch all replies with optional filtering and pagination.

## Query Parameters

<ParamField query="status" type="string">
  Filter by reply status. Options: `pending`, `sent`, `archived`
</ParamField>

<ParamField query="client_id" type="string">
  Filter by client UUID
</ParamField>

<ParamField query="limit" type="number" default="50">
  Number of items to return (max 200)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of items to skip for pagination
</ParamField>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.replyify.ai/api/replies?status=pending&limit=10" \
    -H "Authorization: Bearer rpl_your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://app.replyify.ai/api/replies?status=pending&limit=10',
    {
      headers: {
        'Authorization': 'Bearer rpl_your_api_key'
      }
    }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://app.replyify.ai/api/replies',
      params={'status': 'pending', 'limit': 10},
      headers={'Authorization': 'Bearer rpl_your_api_key'}
  )
  data = response.json()
  ```
</CodeGroup>

## Response Example

```json theme={null}
{
  "data": [
    {
      "id": "uuid",
      "workspace_id": "uuid",
      "client_id": "uuid",
      "contact_id": "uuid",
      "connection_id": "uuid",
      "from_email": "lead@example.com",
      "from_name": "John Doe",
      "to_email": "you@company.com",
      "subject": "Re: Our services",
      "body_text": "I'm interested, let's chat.",
      "source": "instantly",
      "thread_id": "uuid",
      "status": "pending",
      "category_id": "uuid",
      "ai_category": "interested",
      "ai_sentiment": "positive",
      "ai_response": "Thanks for your interest...",
      "received_at": "2025-01-27T12:00:00Z",
      "created_at": "2025-01-27T12:00:00Z",
      "clients": {
        "id": "uuid",
        "name": "Acme Corp Campaign"
      },
      "contacts": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "lead@example.com"
      },
      "categories": {
        "id": "uuid",
        "name": "Interested",
        "slug": "interested",
        "color": "#22c55e",
        "is_positive": true
      }
    }
  ]
}
```