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

# List historical search requests

> Returns paginated historical screening/search request metadata for the authenticated tenant. Use this endpoint for audit-purpose search history retrieval when reconciling screenings that were run in Minerva.



## OpenAPI

````yaml /api-reference/core.json get /v2/search/requests
openapi: 3.0.0
info:
  version: 1.6.2
  title: MinervaAI Core API
  description: >-
    The MinervaAI core monolith that serves the search, consensus, pruning, and
    report generation capabilities.
servers:
  - url: https://api.gominerva.com
    description: The production API server for Minerva AI
security:
  - ApiKeyAuth: []
tags:
  - name: Search
    description: >-
      Current screening, search, and reporting endpoints for active
      integrations.
  - name: Legacy
    description: >-
      Legacy endpoints retained for backwards compatibility. Prefer the
      canonical POST-based search flows for new integrations.
  - name: API to UI Integration
    description: Endpoints used to bridge API integrations with Minerva UI workflows.
  - name: Potential Matches
    description: Update review workflow state for potential matches returned by searches.
paths:
  /v2/search/requests:
    get:
      tags:
        - Search
      summary: List historical search requests
      description: >-
        Returns paginated historical screening/search request metadata for the
        authenticated tenant. Use this endpoint for audit-purpose search history
        retrieval when reconciling screenings that were run in Minerva.
      parameters:
        - name: page
          in: query
          required: false
          description: One-based result page. Defaults to 1.
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: limit
          in: query
          required: false
          description: >-
            Maximum number of requests to return. Defaults to 10 and is capped
            at 250.
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 250
        - name: q
          in: query
          required: false
          description: Case-insensitive search against submitted entity names.
          schema:
            type: string
        - name: job_id
          in: query
          required: false
          description: Return requests associated with a specific search job id.
          schema:
            type: string
        - name: created_at_from
          in: query
          required: false
          description: >-
            Inclusive lower bound for the request created_at timestamp. Provide
            an RFC3339 date-time with an explicit timezone, for example
            2026-05-01T00:00:00Z. URL clients should percent-encode reserved
            characters such as ':' when constructing query strings manually.
          schema:
            type: string
            format: date-time
        - name: created_at_to
          in: query
          required: false
          description: >-
            Inclusive upper bound for the request created_at timestamp. Provide
            an RFC3339 date-time with an explicit timezone, for example
            2026-05-31T23:59:59Z. URL clients should percent-encode reserved
            characters such as ':' when constructing query strings manually.
          schema:
            type: string
            format: date-time
        - name: sort_key
          in: query
          required: false
          description: >-
            Field used to sort the result set. Only created_at is currently
            supported.
          schema:
            type: string
            enum:
              - created_at
            default: created_at
        - name: sort
          in: query
          required: false
          description: Sort direction for created_at. Defaults to desc.
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: Paginated historical search requests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchRequestsListResponse'
        '400':
          description: Bad request. Query parameters are invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchHistoryError'
        '401':
          description: Unauthorized. Authentication headers are missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchHistoryError'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchHistoryError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    SearchRequestsListResponse:
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/SearchHistoryPagination'
        requests:
          type: array
          items:
            $ref: '#/components/schemas/SearchRequestHistoryRecord'
      required:
        - pagination
        - requests
    SearchHistoryError:
      type: object
      properties:
        message:
          type: string
          example: created_at_from must be a valid RFC3339 date-time.
      required:
        - message
    SearchHistoryPagination:
      type: object
      properties:
        page:
          type: integer
          example: 1
        limit:
          type: integer
          example: 25
        total_count:
          type: integer
          example: 42
        total_pages:
          type: integer
          example: 2
        has_next:
          type: boolean
          example: true
        has_prev:
          type: boolean
          example: false
      required:
        - page
        - limit
        - total_count
        - total_pages
        - has_next
        - has_prev
    SearchRequestHistoryRecord:
      type: object
      description: Historical search request metadata for the authenticated tenant.
      properties:
        id:
          type: string
          example: 665f0d4c2d2f7c2b2f2f2f2f
        legacy_search_id:
          type: string
          example: legacy-search-123
        tenant_id:
          type: string
          example: org_123
        config:
          type: object
          additionalProperties: true
        entities:
          type: array
          items:
            $ref: '#/components/schemas/SearchRequestHistoryEntity'
        created_at:
          type: string
          format: date-time
          example: '2026-05-14T13:22:45Z'
        updated_at:
          type: string
          format: date-time
          example: '2026-05-14T13:22:48Z'
        user_id:
          type: string
          example: user_123
        user_name:
          type: string
          example: Compliance Analyst
        user_email:
          type: string
          format: email
          example: analyst@example.com
        job_id:
          type: string
          nullable: true
          example: 665f0d4c2d2f7c2b2f2f2f30
      required:
        - id
        - tenant_id
        - config
        - entities
        - created_at
        - updated_at
        - job_id
    SearchRequestHistoryEntity:
      type: object
      description: >-
        Entity submitted in a historical search request. Additional entity
        fields may be present depending on the original search input.
      properties:
        type:
          type: string
          example: individual
        name:
          type: string
          example: Jane Doe
        feeds:
          type: array
          items:
            type: string
          example:
            - Sanctions
            - PEP
        custom_id:
          type: string
          example: case-1001
      required:
        - name
        - feeds
      additionalProperties: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        The Minerva API key used for this integration. Manage API keys in the
        Minerva dashboard under Administration > Developers.

````