SearchRequest

  • query
    Type: string
    required

    Search query text

  • filters
    Type: object · SearchFilters

    Optional filters to narrow search results

    • court_ids
      Type: array string[]

      Filter by court IDs (e.g., "ca9", "scotus", "nysd")

    • date_filed
      Type: object

      Filter by filing date range

    • jurisdictions
      Type: array string[]enum

      Filter by jurisdiction type using canonical values from Midpage court metadata.

      values
      • Federal Appellate
      • Federal District
      • State Supreme
      • State Appellate
      • State Trial
    • publish_status
      Type: stringenum

      Filter by publication status. Use unknown to include opinions where publication metadata is missing or uncertain.

      values
      • published
      • unpublished
      • unknown
      • in_chambers
      • separate
      • errata
      • relating_to
    • states
      Type: array string[]enum

      Filter by state using full canonical names from Midpage court metadata.

      values
      • Alabama
      • Alaska
      • Arizona
      • Arkansas
      • California
  • include_facets
    Type: boolean

    Include facet breakdowns in the response showing result counts by court, jurisdiction, state, and year. Defaults to false. Set to true to enable.

    Note: Facets are only available in keyword and hybrid modes (not semantic). In hybrid mode, facet counts reflect keyword search results only; semantic results are not included.

  • mode
    Type: stringenum

    Search mode:

    • semantic - Vector similarity search (default)
    • keyword - Full-text search
    • hybrid - Combined semantic and keyword results using reciprocal rank fusion (RRF)
    values
    • semantic
    • keyword
    • hybrid
  • page
    Type: integer
    min:  
    1

    Page number (1-indexed)

  • page_size
    Type: integer
    min:  
    1
    max:  
    100

    Results per page (max 100)