> ## 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 Citing Cases

> Returns later judgments that cite the given case. Combines direct case-to-case citations with action-number citations (where the citing case mentioned an action number that wasn't resolved to a case ID by the citation parser). Results are deduplicated by `case_id` and sorted by `publish_date` descending. Pagination is not supported — the full list is returned in a single response.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/cases/{id}/cited-by
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/cases/{id}/cited-by:
    get:
      tags:
        - Cases
      summary: Get Citing Cases
      description: >-
        Returns later judgments that cite the given case. Combines direct
        case-to-case citations with action-number citations (where the citing
        case mentioned an action number that wasn't resolved to a case ID by the
        citation parser). Results are deduplicated by `case_id` and sorted by
        `publish_date` descending. Pagination is not supported — the full list
        is returned in a single response.
      parameters:
        - name: id
          in: path
          required: true
          description: >-
            Case identifier — case ID, neutral citation, or action number. Same
            format as `GET /v1/cases/{id}`.
          schema:
            type: string
          example: HKCFA_2021_12
      responses:
        '200':
          description: List of citing cases.
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CitedByResponse'
              example:
                case_id: HKCFA_2021_12
                total: 2
                citing_cases:
                  - case_id: HKCA_2023_487
                    case_name: Smith v AG
                    neutral_citation: '[2023] HKCA 487'
                    publish_date: '2023-09-15'
                    citation_text: '[2021] HKCFA 12'
                  - case_id: HKCFI_2022_1843
                    case_name: Lee v Commissioner of Police
                    neutral_citation: '[2022] HKCFI 1843'
                    publish_date: '2022-07-04'
                    citation_text: '[2021] HKCFA 12'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/CaseNotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  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
  schemas:
    CitedByResponse:
      type: object
      required:
        - case_id
        - total
        - citing_cases
      properties:
        case_id:
          type: string
          description: >-
            The cited (target) case — canonical ID, regardless of how you
            supplied it.
        total:
          type: integer
          description: Number of unique citing cases.
        citing_cases:
          type: array
          items:
            $ref: '#/components/schemas/CitingCase'
    CitingCase:
      type: object
      required:
        - case_id
      properties:
        case_id:
          type: string
          example: HKCA_2023_487
        case_name:
          type:
            - string
            - 'null'
        neutral_citation:
          type:
            - string
            - 'null'
        publish_date:
          type:
            - string
            - 'null'
          format: date
        citation_text:
          type: string
          description: The exact citation string used by the citing case.
    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
  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.
    CaseNotFound:
      description: No case matched the supplied identifier.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: case_not_found
              message: No case matched that identifier.
              details:
                identifier: HKCFA_9999_0
    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.
  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.