---
title: "Fetch case timeline"
method: GET
path: "/cases/{id}/timeline"
tags: ["Cases"]
---

# Fetch case timeline

`GET /cases/{id}/timeline`

Returns the complete chronological event history for a case along with the current engagement phase.

**Timeline Events Include:**
- Case assignment to collection partner
- Status changes and lifecycle transitions
- Payment recordings
- Document uploads
- Communication events
- Fee additions
- Manual updates and notes
- System-generated events

**Response shape:**
- `items` — chronological list of timeline events
- `currentEngagementPhase` — current phase of the active engagement: "Pre-legal", "Legal", or "Enforcement". Null when no active engagement exists.

**Use Case:**
Use this to track case progress, understand case history, audit actions, or display activity to users. Timeline events are ordered chronologically and include timestamps, event types, titles, and descriptions.

**Note:** Timeline is filtered to show partner-relevant events only.

## Path parameters

- `id` string, uuid, required

## Response `200`

Timeline returned

- DebituraWebExternalApiContractsV1CasesCaseTimelineResponse — Response envelope for GET /cases/{id}/timeline. Wraps the chronological event list with case-level context that cannot be expressed as a single timeline entry.
  - `items` DebituraWebExternalApiContractsV1CasesTimelineItemDto[], nullable, required — Chronological list of events on the case.
    - `date` string, date-time
    - `type` string, nullable, required
    - `title` string, nullable, required
    - `description` string, nullable, required
    - `actor` DebituraWebExternalApiContractsV1CasesTimelineActorDto — Represents the actor (person or system) that performed a timeline action.
      - `type` string, nullable, required — The type of actor. One of: "System", "Creditor user", "Partner user".
      - `name` string, nullable — Display name of the actor, if available.
  - `currentEngagementPhase` string, nullable — The current engagement phase of the case, sourced from CaseEngagement.CurrentPhase. Possible values: "Pre-legal", "Legal", "Enforcement". Null when no active engagement exists (e.g. case not yet assigned to a partner).

## Other responses

- `400` — Case ID missing or empty
- `404` — Case not found or not assigned to you as collection partner

---

[API](https://skmtc.net/debitura/apis/debitura-collection-partner-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-collection-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-collection-partner-api/revisions/d0dcc5024bd1/schema)
