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

# Get Reminder Emails

> Retrieve emails with active reminders sorted by reminder time

<Note>
  Track all emails with reminders set. Essential for follow-up management and ensuring timely responses to important leads.
</Note>

## Overview

Retrieves emails with active reminders. Unique sorting by reminder time (ascending/descending) helps prioritize upcoming vs overdue reminders.

**Reminder Sorting (Unique to this endpoint):**

* `REMINDER_TIME_DESC`: Most recent/future reminders first
* `REMINDER_TIME_ASC`: Earliest/overdue reminders first (recommended for daily review)

## Query Parameters

<ParamField query="api_key" type="string" required>
  Your SmartLead API key
</ParamField>

<Warning>
  **Note**: This endpoint does NOT support `fetch_message_history` parameter (unlike other inbox endpoints)
</Warning>

## Request Body

<ParamField body="offset" type="number" default="0">
  Pagination offset
</ParamField>

<ParamField body="limit" type="number" default="20">
  Records per page (1-20)
</ParamField>

<ParamField body="filters" type="object">
  Filter object with the following optional fields: `search` (string), `campaignId` (number or array, max 5), `emailAccountId` (number or array, max 10), `emailStatus` (string or array — valid values: `Opened`, `Clicked`, `Replied`, `Unsubscribed`, `Bounced`, `Accepted`, `Not Replied`), `leadCategories` (object with `categoryIdsIn`, `categoryIdsNotIn`, `unassigned`, `isAssigned`), `campaignTeamMemberId` (number or array, max 10), `campaignTagId` (number or array, max 10), `campaignClientId` (number or array, max 10), `replyTimeBetween` (array of 2 date strings).
</ParamField>

<ParamField body="sortBy" type="string">
  **Unique Sort Options:**

  * `REMINDER_TIME_ASC`: Earliest reminders first (overdue → upcoming)
  * `REMINDER_TIME_DESC`: Latest reminders first (upcoming → overdue)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/reminders?api_key=YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{"sortBy": "REMINDER_TIME_ASC", "limit": 20}'
  ```

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

  API_KEY = "YOUR_API_KEY"

  # Get overdue reminders first
  payload = {
      "sortBy": "REMINDER_TIME_ASC",  # Oldest first
      "limit": 20
  }

  response = requests.post(
      "https://server.smartlead.ai/api/v1/master-inbox/reminders",
      params={"api_key": API_KEY},
      json=payload
  )

  reminders = response.json()
  for msg in reminders.get('messages', []):
      print(f"⏰ {msg['lead']['email']} - Reminder: {msg['reminder_time']}")
  ```

  ```javascript JavaScript theme={null}
  const API_KEY = 'YOUR_API_KEY';

  // Get today's due reminders
  const payload = {
    sortBy: 'REMINDER_TIME_ASC',
    limit: 20
  };

  const response = await fetch(
    `https://server.smartlead.ai/api/v1/master-inbox/reminders?api_key=${API_KEY}`,
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(payload)
    }
  );

  const result = await response.json();
  console.log(`${result.total_count} reminders`);
  ```
</RequestExample>

## Response Example

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "messages": [{
      "campaign_lead_map_id": "2433664091",
      "lead": {"email": "john@company.com"},
      "reminder_time": "2025-01-20T14:00:00Z",
      "reminder_message": "Follow up on pricing question",
      "is_overdue": false
    }],
    "total_count": 1
  }
  ```
</ResponseExample>

## Related Endpoints

* [Set Reminder](/api-reference/inbox/set-reminder)
* [Create Task](/api-reference/inbox/create-task)