Get cases

Description

This service retrieves cases assigned to the authenticated user. Its behavior adapts based on the login type:

• Operator Login: Returns cases assigned to the current operator.

• Operator "Run as Party": Returns cases belonging to that specific party.

• Party Login: Returns cases belonging to that specific party.

Note: Cases with a type marked as "Not Visible in APP" are automatically excluded from the results.

---

Request

Restrictions

Requires an authenticated user (successful consumer or operator login).

Endpoint

GET https://<server-url>/api/v4/cases/{case_id}

Path Parameters

Parameter	Type	Description
case_id	Integer	Optional. The unique ID of a specific case. If omitted, the service returns all cases assigned to the user.

Parameters

Parameter	Location	Description
touchpoint	Query / Header	The identifier for the touchpoint. Use Thalamus-Touchpoint for the header.
token	Query / Header	The authentication token for the API session. Use Thalamus-Token for the header.

---

Response

✅ Successful Response: 200 OK

Option 1: All Cases (No case_id provided)

Returns a JSON object containing an array of cases.

JSON

{  
   "cases": [  
      {  
         "id": 1,
         "categoryCode": "cat_1", 
         "typeCode": "type_1", 
         "status": "Open",
         "resolution": "Unresolved",
         "comments": [ ... ],
         "caseData": { "links": [] },
         "attachements": [ ... ],
         "assignedTo": "[email protected]"
      }
   ]
}

Option 2: Specific Case (case_id provided)

Returns the single case object directly.

JSON

{  
   "id": 1,
   "categoryCode": "cat_1", 
   "typeCode": "type_1", 
   "status": "Open",
   "resolution": "Unresolved",
   "comments": [
      {  
         "caseInstanceId": 1,
         "description": "First Note"
      }
   ],
   "caseData": { "links": [] },
   "attachements": [
      {
         "id": 1,
         "url": "https://thalamus-files.s3.amazonaws.com/..."
      }
   ],
   "assignedTo": "[email protected]"
}

---

❌ Unsuccessful Response

400 Bad Request

Error Code	Description
invalidId	The caseInstanceId does not exist, or the authenticated operator/touchpoint is not authorized to access this specific case.