> ## 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 Follow-ups

> Retrieve follow-up activities for your workspace

Follow-ups are scheduled emails sent to contacts at a specific time. They can be created manually or generated automatically by AI.

## Query Parameters

<ParamField query="status" type="string" default="active">
  Filter by status group:

  * `active` — scheduled and sending follow-ups
  * `completed` — sent, failed, and cancelled follow-ups
  * `all` — everything
</ParamField>

<ParamField query="reply_id" type="string">
  Filter by the reply this follow-up is linked to
</ParamField>

<ParamField query="contact_id" type="string">
  Filter by contact ID
</ParamField>

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

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

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.replyify.ai/api/follow-ups?status=active" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://app.replyify.ai/api/follow-ups?status=active",
    { headers: { Authorization: "Bearer YOUR_API_KEY" } }
  );
  const { data } = await response.json();
  ```

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

  response = requests.get(
      "https://app.replyify.ai/api/follow-ups",
      params={"status": "active"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )
  data = response.json()["data"]
  ```
</CodeGroup>

### Example Response

```json theme={null}
{
  "data": [
    {
      "id": "uuid",
      "workspace_id": "uuid",
      "reply_id": "uuid",
      "contact_id": "uuid",
      "client_id": "uuid",
      "action": "follow_up_message",
      "notes": "Mention the pricing discussion",
      "draft_message": "Hi John, following up on our pricing chat...",
      "due_at": "2025-02-01T10:00:00Z",
      "status": "scheduled",
      "assigned_to": "uuid",
      "created_by": "uuid",
      "source": "manual",
      "created_at": "2025-01-27T12:00:00Z",
      "contacts": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "lead@example.com"
      },
      "clients": {
        "id": "uuid",
        "name": "Acme Corp Campaign"
      },
      "replies": {
        "id": "uuid",
        "from_name": "John Doe",
        "from_email": "lead@example.com",
        "subject": "Re: Our services"
      }
    }
  ]
}
```