LawsSearchRequest

  • query
    Type: string
    required

    Full-text query, matched against document text, headings, and citations

  • collection_types
    Type: array string[] enum
    values
    • statute
    • regulation
    • constitution
    • guidance
    • executive_order
    • notice
  • collections
    Type: array string[]

    Restrict to collection ids or human-readable names (see /laws/collections). Values are resolved server-side.

  • current_only
    Type: boolean

    When true (default), only documents that are the law in force today. Currency is derived — not historical, not future-effective, no in-force successor version.

  • effective_date_from
    Type: string Format: date

    full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21

  • effective_date_to
    Type: string Format: date

    full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21

  • page
    Type: integer
    min:  
    1

    Integer numbers.

  • page_size
    Type: integer
    min:  
    1
    max:  
    50

    Integer numbers.

  • path_prefix
    Type: string

    Restrict to a subtree via a dot-separated ltree path prefix. Pair with collections — paths are only unique within a collection.

  • publication_date_from
    Type: string Format: date

    full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21

  • publication_date_to
    Type: string Format: date

    full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21

  • states
    Type: array string[]

    State names or USPS abbreviations; federal law is "Federal". Values are validated server-side.