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

# Fetch Case

> ```
GET api/v1/case-management/case/{id}
```


<Note>
  This endpoint returns the full case record including all comments, task statuses, file attachments, and the complete activity log. Use this to display the case detail view or to audit the full history of an investigation.
</Note>


## OpenAPI

````yaml case-management-model.json GET /case-management/case/{id}
openapi: 3.1.0
info:
  title: Sigma Case Management API
  description: Case Management API documentation
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: https://sigmaprod.sabipay.com/api/v1
    description: Production
  - url: https://sigmastaging.sabipay.com/api/v1
    description: Sandbox
security:
  - ApiKey: []
    ApiSecret: []
paths:
  /case-management/case/{id}:
    get:
      summary: Fetch Case
      description: >-
        Returns the full details of a single case by its ID, including all
        comments, attachments, tasks, and the complete activity log.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The ID of the case to retrieve.
          example: 6801c4f2a3b7d8e9f1c2d3e4
      responses:
        '200':
          description: Case returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchCaseResponse'
              example:
                message: Case fetched successfully
                data:
                  _id: 6801c4f2a3b7d8e9f1c2d3e4
                  businessProfile: 63f0a1b2c3d4e5f6a7b8c9d0
                  module: transaction-monitoring
                  record:
                    id: 64f1a2b3c4d5e6f7a8b9c0d1
                    type: transaction
                    name: TXN-00123456
                  title: High-value transaction requiring review
                  description: >-
                    A transfer of ₦4,500,000 was flagged by the fraud scoring
                    engine with a score of 87. The customer has no prior history
                    of transactions of this size. Requires manual review before
                    release.
                  priority: high
                  status: in progress
                  assignedTo:
                    _id: 64a9f1c2d3e4b5a6c7d8e9f0
                    firstName: Amaka
                    lastName: Osei
                  assignedBy:
                    _id: 63e8b0a1c2d3f4e5a6b7c8d9
                    firstName: Tunde
                    lastName: Adeyemi
                  dueDate: '2026-04-25T23:59:59.000Z'
                  tasks:
                    - _id: 6801c4f2a3b7d8e9f1c2d3e5
                      text: Review customer transaction history for the last 90 days
                      status: true
                    - _id: 6801c4f2a3b7d8e9f1c2d3e6
                      text: Verify source of funds documentation
                      status: false
                    - _id: 6801c4f2a3b7d8e9f1c2d3e7
                      text: Check customer against internal watchlist
                      status: false
                    - _id: 6801c4f2a3b7d8e9f1c2d3e8
                      text: Record final decision with supporting notes
                      status: false
                  comments:
                    - _id: 6801e5b3c4d9f0a1b2c3d4e5
                      text: >-
                        Reviewed last 90 days of transaction history — no
                        comparable transfers. Customer profile shows consistent
                        low-value retail transactions. Flagging for source of
                        funds verification.
                      user:
                        _id: 64a9f1c2d3e4b5a6c7d8e9f0
                        firstName: Amaka
                        lastName: Osei
                      attachments: []
                      taggedUsers: []
                      date: '2026-04-22T11:30:00.000Z'
                  attachments: []
                  isEscalated: false
                  log:
                    - _id: 6801c4f2a3b7d8e9f1c2d3e9
                      status: open
                      message: Case created
                      user:
                        _id: 63e8b0a1c2d3f4e5a6b7c8d9
                        firstName: Tunde
                        lastName: Adeyemi
                      date: '2026-04-22T09:15:42.000Z'
                    - _id: 6801d0e1f2a3b4c5d6e7f8a9
                      status: in progress
                      message: Status updated to in progress
                      user:
                        _id: 64a9f1c2d3e4b5a6c7d8e9f0
                        firstName: Amaka
                        lastName: Osei
                      date: '2026-04-22T10:00:00.000Z'
                  createdAt: '2026-04-22T09:15:42.000Z'
                  updatedAt: '2026-04-22T11:30:00.000Z'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Invalid API credentials
        '404':
          description: Case not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Case not found
components:
  schemas:
    FetchCaseResponse:
      type: object
      properties:
        message:
          type: string
          example: Case fetched successfully
        data:
          $ref: '#/components/schemas/Case'
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          example: An error occurred
    Case:
      type: object
      properties:
        _id:
          type: string
          description: Unique case identifier.
          example: 6801c4f2a3b7d8e9f1c2d3e4
        businessProfile:
          type: string
          description: The ID of the business this case belongs to.
          example: 63f0a1b2c3d4e5f6a7b8c9d0
        module:
          type: string
          example: transaction-monitoring
        record:
          $ref: '#/components/schemas/CaseRecord'
        title:
          type: string
          example: High-value transaction requiring review
        description:
          type: string
          example: >-
            A transfer of ₦4,500,000 was flagged by the fraud scoring engine
            with a score of 87.
        priority:
          type: string
          enum:
            - low
            - medium
            - high
          example: high
        status:
          type: string
          enum:
            - open
            - in progress
            - resolved
            - closed
          example: open
        assignedTo:
          $ref: '#/components/schemas/CaseUser'
        assignedBy:
          $ref: '#/components/schemas/CaseUser'
        dueDate:
          type: string
          format: date-time
          nullable: true
          example: '2026-04-25T23:59:59.000Z'
        tasks:
          type: array
          items:
            $ref: '#/components/schemas/CaseTask'
        comments:
          type: array
          items:
            type: object
          example: []
        attachments:
          type: array
          items:
            type: string
          example: []
        isEscalated:
          type: boolean
          example: false
        log:
          type: array
          items:
            $ref: '#/components/schemas/CaseLogEntry'
        createdAt:
          type: string
          format: date-time
          example: '2026-04-22T09:15:42.000Z'
        updatedAt:
          type: string
          format: date-time
          example: '2026-04-22T09:15:42.000Z'
    CaseRecord:
      type: object
      description: A reference to an existing Sigma record to link to this case.
      required:
        - id
        - type
      properties:
        id:
          type: string
          description: >-
            The ID of the linked record (e.g. a transaction ID, customer ID, or
            AML screening result ID).
          example: 64f1a2b3c4d5e6f7a8b9c0d1
        type:
          type: string
          description: The type of record being linked.
          example: transaction
        name:
          type: string
          description: A human-readable name or reference for the linked record.
          example: TXN-00123456
    CaseUser:
      type: object
      properties:
        _id:
          type: string
          example: 64a9f1c2d3e4b5a6c7d8e9f0
        firstName:
          type: string
          example: Amaka
        lastName:
          type: string
          example: Osei
    CaseTask:
      type: object
      properties:
        _id:
          type: string
          example: 6801c4f2a3b7d8e9f1c2d3e5
        text:
          type: string
          example: Review customer transaction history for the last 90 days
        status:
          type: boolean
          description: Whether the task has been completed.
          example: false
    CaseLogEntry:
      type: object
      properties:
        _id:
          type: string
          example: 6801c4f2a3b7d8e9f1c2d3e9
        status:
          type: string
          example: open
        message:
          type: string
          example: Case created
        user:
          $ref: '#/components/schemas/CaseUser'
        date:
          type: string
          format: date-time
          example: '2026-04-22T09:15:42.000Z'
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: apiKey
    ApiSecret:
      type: apiKey
      in: header
      name: apiSecret

````