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

# Fetched Searches API

> Retrieve fetched leads (search filters with fetch data) for the authenticated user - GET /search-filters/fetched-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 fetched searches to return (positive integer string). Pattern: ^\[1-9]\[0-9]\*\$. Default: "10".
</ParamField>

<ParamField query="offset" type="string">
  Number of fetched 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/fetched-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": {
      "fetchedLeads": [
        {
          "id": 327107,
          "user_id": 2568,
          "search_string": "Director in United States",
          "filter_details": {
            "title": ["Director"],
            "country": ["United States"],
            "limit": 100
          },
          "type": "saved",
          "include_owned": false,
          "is_saved": true,
          "is_fetched": true,
          "fetch_details": {
            "metrics": {
              "totalContacts": 500,
              "totalEmails": 480,
              "noEmailFound": 20,
              "invalidEmails": 10,
              "catchAllEmails": 5,
              "verifiedEmails": 465,
              "completed": 480
            },
            "leads_found": 500,
            "email_fetched": 480
          },
          "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>
