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

# Handles `GET /v1/cases/{id}`.

> # Errors

Returns `401` without usable credentials and `404` when the tenant has no
such case.



## OpenAPI

````yaml /openapi.json get /v1/cases/{case_id}
openapi: 3.1.0
info:
  title: Esectra API
  description: >-
    Transaction screening, identity verification, and wallet risk.


    Every create route accepts `Idempotency-Key`; replaying one returns the
    original record with `200` where the first call returned `201`. `POST
    /v1/transactions` requires the header, because a duplicated transaction is a
    duplicated financial record.
  license:
    name: proprietary
    identifier: proprietary
  version: 0.1.0
servers:
  - url: https://qa.esectra.com
    description: Esectra QA Documentation
security: []
paths:
  /v1/cases/{case_id}:
    get:
      tags:
        - Cases
      summary: Handles `GET /v1/cases/{id}`.
      description: >-
        # Errors


        Returns `401` without usable credentials and `404` when the tenant has
        no

        such case.
      operationId: get_case_handler
      parameters:
        - name: case_id
          in: path
          description: Case identifier
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The case
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaseBody'
        '401':
          description: No usable credentials
        '404':
          description: No such case in this tenant
        '503':
          description: A backing store could not be reached
      security:
        - api_key: []
        - session_cookie: []
components:
  schemas:
    CaseBody:
      type: object
      description: A case as returned to a customer.
      required:
        - case_id
        - case_type
        - subject_id
        - decision_id
        - queue
        - severity
        - status
        - notes
        - created_at
        - updated_at
      properties:
        assignee:
          type:
            - string
            - 'null'
          description: Reviewer the case is assigned to.
        case_id:
          type: string
          description: Case identifier.
        case_type:
          $ref: '#/components/schemas/CaseType'
          description: Kind of subject under review.
        created_at:
          type: string
          description: RFC 3339 creation timestamp.
        decision_id:
          type: string
          description: Decision under review.
        disposition:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/CaseDisposition'
              description: What the reviewer concluded.
        notes:
          type: array
          items:
            $ref: '#/components/schemas/CaseNote'
          description: Notes left while working the case.
        queue:
          type: string
          description: Queue the case belongs to.
        reviewer:
          type:
            - string
            - 'null'
          description: Reviewer who resolved it.
        severity:
          $ref: '#/components/schemas/RiskLevel'
          description: How severe the opening decision judged it.
        status:
          $ref: '#/components/schemas/CaseStatus'
          description: Lifecycle status.
        subject_id:
          type: string
          description: Subject the decision was about.
        updated_at:
          type: string
          description: RFC 3339 time of the last change.
    CaseType:
      type: string
      description: What kind of subject a case is about.
      enum:
        - IDENTITY
        - TRANSACTION
        - WALLET
        - CONTENT
        - OTHER
    CaseDisposition:
      type: string
      description: What a reviewer concluded.
      enum:
        - CONFIRMED_RISK
        - FALSE_POSITIVE
        - ACCEPTED_RISK
        - INSUFFICIENT_EVIDENCE
        - CUSTOMER_EXPLAINED
        - ESCALATED
        - OTHER
    CaseNote:
      type: object
      description: A note a reviewer left on a case.
      required:
        - id
        - author
        - body
        - created_at
      properties:
        author:
          type: string
          description: Who wrote it.
        body:
          type: string
          description: What they wrote.
        created_at:
          type: string
          description: RFC 3339 creation timestamp.
        id:
          type: string
          description: Note identifier.
    RiskLevel:
      type: string
      description: Explainable risk level.
      enum:
        - LOW
        - MEDIUM
        - HIGH
        - CRITICAL
    CaseStatus:
      type: string
      description: >-
        Lifecycle status of a review case.


        A case moves forward: it is opened, picked up, and resolved. It never

        silently reopens, because a reopened case would make the audit trail
        read

        as though the first resolution had not happened.
      enum:
        - OPEN
        - IN_REVIEW
        - APPROVED
        - REJECTED
        - ESCALATED
        - CLOSED
  securitySchemes:
    api_key:
      type: http
      scheme: bearer
      description: >-
        A tenant API key. Acts for exactly one tenant and cannot conclude a
        case, because a conclusion records a person.
    session_cookie:
      type: apiKey
      in: cookie
      name: esectra_session
      description: >-
        A signed-in reviewer's session. httpOnly and SameSite=Lax; set by `POST
        /v1/control/sessions` and only usable once the second factor is met.

````