> ## 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.

# Saved Searches API

> Retrieve saved searches (search filters) for the authenticated user - GET /search-filters/saved-searches

<Note>
  This endpoint requires authentication via API key passed as a query parameter (`api_key`).
</Note>

## Query Parameters

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

<ParamField query="limit" type="string">
  Number of saved searches to return (positive integer string). Pattern: ^\[1-9]\[0-9]\*\$. Default: "10".
</ParamField>

<ParamField query="offset" type="string">
  Number of saved searches to skip for pagination (non-negative integer string). Pattern: ^\[0-9]+\$. Default: "0".
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/saved-searches?api_key=YOUR_API_KEY"
  ```
</RequestExample>

## Response Codes

<ResponseField name="200" type="Success">
  Request successful
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Unauthorized
</ResponseField>

<ResponseField name="500" type="Internal Server Error">
  Internal Server Error
</ResponseField>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "success": true,
    "message": "Data retrieved successfully",
    "data": {
      "savedSearches": [
        {
          "id": 327105,
          "search_string": "Director in United States",
          "filter_details": {
            "title": ["Director"],
            "country": ["United States"],
            "limit": 100
          },
          "created_at": "2025-01-15T10:00:00.000Z",
          "updated_at": "2025-01-20T14:30:00.000Z"
        }
      ],
      "totalCount": 1
    }
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "statusCode": 401,
    "success": false,
    "message": "Unauthorized",
    "error": "User not authenticated"
  }
  ```
</ResponseExample>
