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

# List Saved Searches

> Returns a paginated list of saved opportunity searches for your organization

## Request

<ParamField query="page" type="integer" default={1}>
  Page number for pagination
</ParamField>

<ParamField query="per" type="integer" default={50}>
  Number of results per page
</ParamField>

## Response

<ResponseField name="results" type="array">
  Array of saved search objects

  <Expandable title="Saved Search Object">
    <ResponseField name="id" type="string">
      Unique identifier for the saved search
    </ResponseField>

    <ResponseField name="active" type="boolean">
      Whether the saved search is currently active
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp when the saved search was created
    </ResponseField>

    <ResponseField name="createdByEmail" type="string">
      Email of the user who created the saved search
    </ResponseField>

    <ResponseField name="lastMatchedAt" type="string">
      ISO 8601 timestamp when the saved search last found a matching opportunity
    </ResponseField>

    <ResponseField name="matchCount" type="integer">
      Number of opportunities matching the saved search
    </ResponseField>

    <ResponseField name="name" type="string">
      Name of the saved search
    </ResponseField>

    <ResponseField name="query" type="object">
      Search criteria configuration

      <Expandable title="Query Object">
        <ResponseField name="sortDirection" type="string">
          Field to sort results by
        </ResponseField>

        <ResponseField name="feeds" type="array">
          List of contract vehicle feeds to search
        </ResponseField>

        <ResponseField name="query" type="string">
          Search query string
        </ResponseField>

        <ResponseField name="status" type="array">
          List of opportunity statuses to include
        </ResponseField>

        <ResponseField name="buyerIds" type="array">
          List of buyer IDs to filter by
        </ResponseField>

        <ResponseField name="recordType" type="array">
          Types of records to include
        </ResponseField>

        <ResponseField name="sortDirection" type="string">
          Direction to sort results (`asc` or `desc`)
        </ResponseField>

        <ResponseField name="excludeIgnored" type="array">
          List of opportunity IDs to exclude
        </ResponseField>

        <ResponseField name="dateRangeParam" type="string">
          Field to use for date filtering
        </ResponseField>

        <ResponseField name="buyerMatchById" type="boolean">
          Whether to match buyers by ID
        </ResponseField>

        <ResponseField name="includeSubBuyers" type="boolean">
          Whether to include sub-organizations of matched buyers
        </ResponseField>

        <ResponseField name="predictions" type="boolean">
          Whether to include AI-predicted opportunities
        </ResponseField>

        <ResponseField name="searchType" type="string">
          Type of search to perform
        </ResponseField>

        <ResponseField name="searchFields" type="object">
          Configuration for field-specific search options
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 timestamp when the saved search was last updated
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  Pagination metadata

  <Expandable title="Meta Object">
    <ResponseField name="currentPage" type="integer">
      Current page number
    </ResponseField>

    <ResponseField name="per" type="integer">
      Number of results per page
    </ResponseField>

    <ResponseField name="total" type="integer">
      Total number of saved searches
    </ResponseField>

    <ResponseField name="totalPages" type="integer">
      Total number of pages available
    </ResponseField>
  </Expandable>
</ResponseField>