SearchResponse

  • facets
    Type: object · SearchFacets

    Facet breakdowns showing result counts by various dimensions. Only present when include_facets: true in request and mode is keyword or hybrid. Counts are computed across the full result set (after filters), not just the current page.

    • court_abbreviation
      Type: array object[] · FacetBucket[]

      Breakdown by court abbreviation (e.g., "9th Cir.", "S.D.N.Y.")

      A single bucket in a facet breakdown

    • jurisdiction
      Type: array object[] · FacetBucket[]

      Breakdown by jurisdiction type (e.g., "Federal Appellate", "State Trial")

      A single bucket in a facet breakdown

    • note
      Type: string

      Explanatory note about facet limitations. Present in hybrid mode to indicate that facet counts reflect keyword search results only.

    • state
      Type: array object[] · FacetBucket[]

      Breakdown by state name

      A single bucket in a facet breakdown

    • year_filed
      Type: array object[] · FacetBucket[]

      Breakdown by filing year

      A single bucket in a facet breakdown

  • metadata
    Type: object
    • boolean_query
      Type: object

      Present in keyword mode when boolean operators are detected

    • mode
      Type: stringenum

      Search mode used

      values
      • semantic
      • keyword
      • hybrid
    • processing_time_ms
      Type: integer

      Server processing time in milliseconds

    • query
      Type: string

      Original query

  • pagination
    Type: object · PaginationMeta
    • has_next
      Type: boolean

      Whether more pages exist

    • has_prev
      Type: boolean

      Whether previous pages exist

    • page
      Type: integer

      Current page number

    • page_size
      Type: integer

      Results per page

    • total_pages
      Type: integer

      Total pages available

    • total_results
      Type: integer

      Total matching results (capped at 10,000 for keyword/hybrid)

  • results
    Type: array object[] · SearchResultItem[]
    • case_name
      Type: string

      Case name/caption

    • court_abbreviation
      Type: string

      Court citation abbreviation

    • court_id
      Type: string

      Court identifier

    • court_name
      Type: string

      Full court name

    • date_filed
      Type: stringFormat: date

      Filing date (YYYY-MM-DD)

    • docket_number
      Type: string nullable

      Court docket number, when available

    • jurisdiction
      Type: string

      Jurisdiction type

    • opinion_id
      Type: string

      Opinion identifier

    • publish_status
      Type: stringenum nullable

      Publication status, when available

      values
      • published
      • unpublished
      • unknown
      • in_chambers
      • separate
      • errata
      • relating_to
      • null
    • score
      Type: number

      Relevance score. Scale varies by mode:

      • Semantic: 0-1 (cosine similarity)
      • Keyword: 0-100+ (BM25 score)
    • snippet
      Type: string

      Relevant text excerpt from the opinion

    • source
      Type: stringenum

      Source of this result. Always present in API responses:

      • semantic mode: "semantic"
      • keyword mode: "keyword"
      • hybrid mode: varies per item
      values
      • semantic
      • keyword
    • state
      Type: string nullable

      State name (null for federal courts)