> ## 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 Snoozed Emails

> Retrieve emails temporarily snoozed for later follow-up

<Note>
  Manage inbox overflow by retrieving emails snoozed until a specific time. Helps prioritize immediate tasks while ensuring important conversations resurface automatically.
</Note>

## Overview

Retrieves snoozed emails that are scheduled to reappear at a later time. Snoozing helps manage inbox load by temporarily hiding emails that don't require immediate attention.

**Key Features:**

* View all snoozed conversations
* Same filtering as other inbox endpoints (max 5 campaigns, max 10 accounts)
* Automatically reappear when snooze expires
* Bulk snooze management

**Use Cases:**

* Waiting for information before responding
* Follow-up after specific event/date
* Reduce immediate inbox clutter
* Schedule review of low-priority leads

## Query Parameters

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

<ParamField query="fetch_message_history" type="boolean" default="false">
  Include full email thread history
</ParamField>

## 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">
  `REPLY_TIME_DESC` or `SENT_TIME_DESC`
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/snoozed?api_key=YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "offset": 0,
      "limit": 20,
      "filters": {
        "campaignId": 12345,
        "leadCategories": {"categoryIdsIn": [1]}
      }
    }'
  ```

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

  API_KEY = "YOUR_API_KEY"

  # Get all snoozed emails
  response = requests.post(
      "https://server.smartlead.ai/api/v1/master-inbox/snoozed",
      params={"api_key": API_KEY, "fetch_message_history": False},
      json={"offset": 0, "limit": 20, "filters": {}}
  )

  result = response.json()
  print(f"Snoozed emails: {result.get('total_count', 0)}")
  ```

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

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

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

## Response Example

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "messages": [{
      "campaign_lead_map_id": "2433664091",
      "lead": {"email": "john@company.com"},
      "snoozed_until": "2025-01-25T09:00:00Z",
      "email_status": "Replied"
    }],
    "total_count": 1
  }
  ```
</ResponseExample>

## Related Endpoints

* [Get Inbox Messages](/api-reference/inbox/get-messages)
* [Get Reminders](/api-reference/inbox/get-reminders)