> ## 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 search request history

> Returns paginated screening and search request metadata for the authenticated tenant. Use it to retrieve search history for audit purposes, for example 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 Minerva core monolith, which provides search, consensus, pruning, and
    report generation.
servers:
  - url: https://api.gominerva.com
    description: The production API server for Minerva.
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 search request history
      description: >-
        Returns paginated screening and search request metadata for the
        authenticated tenant. Use it to retrieve search history for audit
        purposes, for example 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.

````