> ## 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.

# Get a Daily summary

> Today and the preceding six HKT calendar days, inclusive; rolls at midnight Asia/Hong_Kong. Uses case publication date, not judgment or summary generation date. Weekends count. Only processed, non-empty summaries are returned. See https://docs.casebyte.ai/guides/daily-summaries. Returns 404 summary_not_found for an unknown case, an out-of-window case, or one without a completed non-empty summary. No query parameters accepted.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/daily/summaries/{id}
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/{id}:
    get:
      tags:
        - Daily
      summary: Get a Daily summary
      description: >-
        Today and the preceding six HKT calendar days, inclusive; rolls at
        midnight Asia/Hong_Kong. Uses case publication date, not judgment or
        summary generation date. Weekends count. Only processed, non-empty
        summaries are returned. See
        https://docs.casebyte.ai/guides/daily-summaries. Returns 404
        summary_not_found for an unknown case, an out-of-window case, or one
        without a completed non-empty summary. No query parameters accepted.
      operationId: getDailySummary
      parameters:
        - name: id
          in: path
          required: true
          description: >-
            URL-encoded canonical case_id or neutral citation. Action numbers
            and DIS suffixes are rejected (400 invalid_identifier).
          schema:
            type: string
            maxLength: 200
      responses:
        '200':
          description: Success. Window dates are inclusive.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DailySummaryDetail'
              example:
                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
                window:
                  start: '2026-09-22'
                  end: '2026-09-28'
                  timezone: Asia/Hong_Kong
                matched_by: case_id
        '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'
        '404':
          description: >-
            summary_not_found: no completed non-empty summary matched within the
            active window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    DailySummaryDetail:
      allOf:
        - $ref: '#/components/schemas/DailySummary'
        - type: object
          required:
            - window
            - matched_by
          properties:
            window:
              $ref: '#/components/schemas/DailyWindow'
            matched_by:
              type: string
              enum:
                - case_id
                - neutral_citation
    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
    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
    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
  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.