Retrieve a Case

This endpoint allows you to retrieve a case

GET {{baseurl}}/v2/api/cases/:caseId

Headers

Name	Type	Description
token*	String	API secret token

Parameter

Field	Type	Description
caseId*	String	Unique Id of the case

Retrieve a Case Success Response

{
        "success": true,
        "statusCode": 200,
        "message": "Case retrieved successfully!",
        "data": {
            "caseTitle": "KYC data Mismatch",
            "status": "Opened",
            "caseType": "KYC",
            "severity": "High",
            "parentId": null,
            "businessId": "681d7b30cd275833cb856ff8",
            "entityId": "6880a452495dce07d2f7ff5a",
            "description": "The case was created because there's a complete mismatch between the NIN and BVN data of the client.",
            "evidences": [],
            "linkedIssues": [
                {
                    "issueId": "6880f7d527309cf76eb5db2e",
                    "issueType": "Activity",
                    "dateLinked": null,
                    "status": "Mismatch"
                }
            ],
            "caseStage": [
                {
                    "stage": "Investigation",
                    "level": "LV1",
                    "investigatorId": "681d7b32cd275833cb856fff",
                    "investigatorName": "Jaymee Bottomore",
                    "notes": [],
                    "isReassigned": false,
                    "previousInvestigators": [],
                    "tasks": [
                        {
                            "task": "Investigate KYC verification",
                            "isCompleted": false
                        },
                        {
                            "task": "Gather evidences, and add them to the case.",
                            "isCompleted": false
                        },
                        {
                            "task": "Confirm if entities are same and why there's a mismatch",
                            "isCompleted": false
                        }
                    ],
                    "_id": "68945a37a52eb93b87f827fa"
                }
            ],
            "activities": [
                {
                    "event": "Case Created",
                    "activity": "Case created by Jaymee Bottomore",
                    "createdBy": "Jaymee Bottomore",
                    "userId": "681d7b30cd275833cb856ff8",
                    "eventDateTime": "2025-08-07T07:48:07.145Z",
                    "_id": "68945a37a52eb93b87f827fb"
                }
            ],
            "isDeleted": false,
            "comments": [],
            "createdAt": "2025-08-07T07:48:07.165Z",
            "lastModifiedAt": "2025-08-07T07:48:07.165Z",
            "_createdAt": "2025-08-07T08:48:077+01:00",
            "_lastModifiedAt": "2025-08-07T08:48:077+01:00",
            "object": "case",
            "id": "cas_68945a37a52eb93b87f827f9"
        },
        "links": []
    }

Error Response