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

    • count
      Type: integer

      Number of documents matching this value

    • key
      Type: string

      The value (e.g., "9th Cir.", "Federal Appellate", "2024")

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

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

    A single bucket in a facet breakdown

    • count
      Type: integer

      Number of documents matching this value

    • key
      Type: string

      The value (e.g., "9th Cir.", "Federal Appellate", "2024")

  • 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

    • count
      Type: integer

      Number of documents matching this value

    • key
      Type: string

      The value (e.g., "9th Cir.", "Federal Appellate", "2024")

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

    Breakdown by filing year

    A single bucket in a facet breakdown

    • count
      Type: integer

      Number of documents matching this value

    • key
      Type: string

      The value (e.g., "9th Cir.", "Federal Appellate", "2024")