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

# Case Types

> Standardized case-type classifications used in the CaseXchange Public API

## Endpoint

| Method | Path          | Auth                     | Description                            |
| ------ | ------------- | ------------------------ | -------------------------------------- |
| `GET`  | `/case-types` | `X-API-Key` (read\_only) | Returns all available CaseType objects |

## CaseType Object

| Field         | Type             | Description                                      |
| ------------- | ---------------- | ------------------------------------------------ |
| `id`          | `string (uuid)`  | Unique identifier for the case type              |
| `name`        | `string`         | Machine-readable key (e.g., `"personal_injury"`) |
| `displayName` | `string \| null` | Human-friendly label for UI rendering            |
| `explanation` | `string \| null` | Human-readable explanation of the case type      |

## Sample Response

```json theme={null}
{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "personal_injury",
      "displayName": "Personal Injury",
      "explanation": "Personal injury cases involving bodily harm or negligence"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "medical_malpractice",
      "displayName": "Medical Malpractice",
      "explanation": "Cases involving medical provider negligence or error"
    }
  ],
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-03-31T12:00:00Z"
  }
}
```

## Best Practices

* Validate case type selections against this endpoint before calling `POST /sent-cases`.
* Cache responses to reduce load and ensure consistent dropdown ordering.
* Use `displayName` when rendering options in a UI; fall back to `name` when `displayName` is `null`.

<Card title="Working examples" icon="code" href="/api-reference/examples/reference-data">
  See full request/response examples for reference-data endpoints.
</Card>