Case Types - 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

{
  "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.

Working examples

See full request/response examples for reference-data endpoints.