> ## Documentation Index
> Fetch the complete documentation index at: https://docs.casebyte.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Daily summaries

> Case summaries from the last 7 days. Filter by date or area of law.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/daily/summaries
openapi: 3.1.0
info:
  title: Casebyte API
  description: >-
    REST API for searching and retrieving Hong Kong case law. See the guides at
    https://docs.casebyte.ai for tutorials and conceptual overviews.
  version: 1.1.0
  contact:
    name: Casebyte support
    email: support@casebyte.ai
    url: https://casebyte.ai
  license:
    name: Proprietary
servers:
  - url: https://api.casebyte.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Cases
    description: Search and retrieve Hong Kong case law.
  - name: Health
    description: Service health checks.
  - name: Daily
    description: Completed case summaries within the active seven Hong Kong calendar days.
paths:
  /v1/daily/summaries:
    get:
      tags:
        - Daily
      summary: List Daily summaries
      description: Case summaries from the last 7 days. Filter by date or area of law.
      operationId: listDailySummaries
      parameters:
        - name: date
          in: query
          description: >-
            HKT publication day within the active window. Omit for all seven
            days. Empty, invalid or out-of-window dates return 400.
          schema:
            type: string
            format: date
        - name: area_of_law
          in: query
          description: >-
            One Daily label; case-insensitive with surrounding spaces ignored.
            Labels containing commas are single values.
          schema:
            type: string
            enum:
              - Administrative Law
              - Alternative Dispute Resolution
              - Banking and finance
              - Building and Construction
              - Civil Procedure
              - Commercial law
              - Company Law
              - Conflict of Laws
              - Constitutional Law
              - Contract
              - Courts and judicial system
              - Criminal
              - Employment
              - Environment
              - Equity
              - Evidence
              - Family
              - Immigration
              - Non-Refoulement
              - Insurance
              - Intellectual property
              - Land & Property
              - Professions
              - Public International Law
              - Remedies
              - Taxation
              - Tort
              - Transportation
              - Trusts
              - Wills, probate and succession
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: offset
          in: query
          schema:
            type: integer
            minimum: 0
            maximum: 10000
            default: 0
      responses:
        '200':
          description: Success. Window dates are inclusive.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DailySummaryList'
              example:
                window:
                  start: '2026-09-22'
                  end: '2026-09-28'
                  timezone: Asia/Hong_Kong
                date: null
                area_of_law: null
                total: 1
                limit: 20
                offset: 0
                has_more: false
                results:
                  - case_id: HKCFI_2026_123
                    case_name: Example case
                    court: HKCFI
                    neutral_citation: '[2026] HKCFI 123'
                    action_numbers:
                      - HCAL 1/2026
                    publish_date: '2026-09-28'
                    area_of_law: Administrative Law
                    area_of_law_subtype: null
                    catchwords: null
                    summary: Illustrative summary text.
                    casebyte_url: https://casebyte.ai/case/hkcfi/2026/123
        '400':
          description: >-
            Invalid parameters. Codes: invalid_query, invalid_date,
            date_out_of_window, invalid_area_of_law, invalid_int, invalid_range,
            invalid_identifier.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    DailySummaryList:
      type: object
      required:
        - window
        - date
        - area_of_law
        - total
        - limit
        - offset
        - has_more
        - results
      properties:
        window:
          $ref: '#/components/schemas/DailyWindow'
        date:
          type:
            - string
            - 'null'
          format: date
          description: Selected day, or null for the full active window.
        area_of_law:
          type:
            - string
            - 'null'
          description: Canonical selected label, or null for all areas.
        total:
          type: integer
          minimum: 0
        limit:
          type: integer
          minimum: 1
          maximum: 100
        offset:
          type: integer
          minimum: 0
          maximum: 10000
        has_more:
          type: boolean
        results:
          type: array
          items:
            $ref: '#/components/schemas/DailySummary'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: >-
                Stable, machine-readable error code. Branch on this in your
                code.
            message:
              type: string
              description: >-
                Human-readable summary. May change between versions; do not
                branch on this.
            details:
              description: Optional, endpoint-specific extra context.
              nullable: true
    DailyWindow:
      type: object
      required:
        - start
        - end
        - timezone
      properties:
        start:
          type: string
          format: date
          description: First included HKT publication day (today minus six days).
        end:
          type: string
          format: date
          description: Last included HKT publication day (today).
        timezone:
          type: string
          const: Asia/Hong_Kong
    DailySummary:
      type: object
      required:
        - case_id
        - case_name
        - court
        - neutral_citation
        - action_numbers
        - publish_date
        - area_of_law
        - area_of_law_subtype
        - catchwords
        - summary
        - casebyte_url
      properties:
        case_id:
          type: string
          description: Canonical COURT_YEAR_NUM identifier.
        case_name:
          type: string
        court:
          type:
            - string
            - 'null'
          description: Stored court code.
        neutral_citation:
          type:
            - string
            - 'null'
          description: Neutral citation, when available.
        action_numbers:
          type: array
          items:
            type: string
        publish_date:
          type: string
          format: date
          description: >-
            HKT day of the case publication timestamp; not judgment or summary
            generation date.
        area_of_law:
          type:
            - string
            - 'null'
          description: Daily classification, including the Non-Refoulement override.
        area_of_law_subtype:
          type:
            - string
            - 'null'
          description: Stored subtype, when available.
        catchwords:
          type:
            - string
            - 'null'
          description: Catchwords, when available.
        summary:
          type: string
          minLength: 1
          description: Summary text without paragraph citations.
        casebyte_url:
          type: string
          format: uri
  responses:
    Unauthorized:
      description: Missing, malformed, or revoked credentials.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            missing:
              summary: No Authorization header
              value:
                error:
                  code: missing_credentials
                  message: Authorization header with a Bearer token is required.
            invalid:
              summary: Unrecognised key
              value:
                error:
                  code: invalid_credentials
                  message: API key not recognised.
            revoked:
              summary: Revoked key
              value:
                error:
                  code: revoked_credentials
                  message: API key has been revoked.
    RateLimited:
      description: >-
        You exceeded your per-minute quota. Back off with exponential delay and
        jitter — `Retry-After` is intentionally not returned.
      headers:
        X-RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: rate_limited
              message: Rate limit exceeded.
    InternalError:
      description: Something went wrong on our side. Retry with exponential backoff.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: internal_error
              message: Internal server error.
  headers:
    RateLimitLimit:
      description: Per-window quota for this API key.
      schema:
        type: integer
      example: 10
    RateLimitRemaining:
      description: Requests remaining in the current window.
      schema:
        type: integer
      example: 9
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: cb_live_*
      description: >-
        Casebyte API key, prefixed with `cb_live_`. Generate one from your
        [casebyte.ai dashboard](https://casebyte.ai/dashboard).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.