# Get case status

### Description

This service retrieves the list of active case statuses configured in the system. It indicates which statuses are valid for starting a case and which represent a final (closed) state in the workflow.

***

### Request

#### Restrictions

* Authentication: Requires an authenticated user (successful party/consumer login).

#### Endpoint

```
GET https://<server-url>/api/v4/cases/status
```

#### 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. |

#### Full URL Example

```
https://<server-url>/api/v4/cases/status?touchpoint=test&token=...
```

***

### Response

#### ✅ Successful Response: `200 OK`

Returns a JSON object containing an array of `caseStatuses`.

| **Field**    | **Type** | **Description**                                                |
| ------------ | -------- | -------------------------------------------------------------- |
| `statusName` | String   | The display name of the status.                                |
| `initial`    | Boolean  | If `true`, this status can be used when creating a new case.   |
| `finalState` | Boolean  | If `true`, this status represents a completed or closed state. |

Example Response Body:

```
{
    "caseStatuses": [
        {
            "statusName": "Open",
            "initial": true,
            "finalState": false
        },
        {
            "statusName": "In progress",
            "initial": false,
            "finalState": false
        },
        {
            "statusName": "Closed",
            "initial": false,
            "finalState": true
        }
    ]
}
```