---
title: "Get case timeline"
method: GET
path: "/api/v2/cases/{case_id}/timelines"
tags: ["Case Management"]
---

# Get case timeline

`GET /api/v2/cases/{case_id}/timelines`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/cases/{case_id}/timelines`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `cases_read`

Returns the timeline of events for a case, including comments, status changes, and other activity. Supports pagination and sort order.

## Path parameters

- `case_id` string, required

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `sort[ascending]` boolean

## Response `200`

OK

- TimelineResponse: Response containing the chronological list of timeline cells for a case.
  - `data` TimelineCellResource[]: The `TimelineResponse` `data`.
    - `attributes` TimelineCell, required: Attributes of a timeline cell, representing a single event in a case's chronological activity log (for example, a comment, status change, or assignment update).
      - `author` TimelineCellAuthor: A user who authored a timeline cell.
        - `content` TimelineCellAuthorUserContent: Profile information for the user who authored the timeline cell.
          - `email` string: The email address of the user.
          - `handle` string: The Datadog handle of the user.
          - `id` string: The UUID of the user.
          - `name` string: The display name of the user.
        - `type` 'USER': The type of timeline cell author. Currently only `USER` is supported.
      - `cell_content` TimelineCellContent: The content of a comment timeline cell.
        - `message` string: The text content of the comment. Supports Markdown formatting.
      - `created_at` string, date-time: Timestamp of when the cell was created
      - `deleted_at` string, date-time: Timestamp of when the cell was deleted
      - `modified_at` string, date-time: Timestamp of when the cell was last modified
      - `type` 'COMMENT': The type of content in the timeline cell. Currently only `COMMENT` is supported in this endpoint.
    - `id` string, required: Timeline cell's identifier
    - `type` 'timeline_cell', required: JSON:API resource type for timeline cells.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)