---
title: "Get a case view"
method: GET
path: "/api/v2/cases/views/{view_id}"
tags: ["Case Management"]
---

# Get a case view

`GET /api/v2/cases/views/{view_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/cases/views/{view_id}`
- 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 a single saved case view identified by its UUID, including its query, associated project, and timestamps.

## Path parameters

- `view_id` string, required

## Response `200`

OK

- CaseViewResponse: Response containing a single case view.
  - `data` CaseView, required: A saved case view that provides a filtered, reusable list of cases matching a specific query. Views act as persistent dashboards for monitoring case subsets.
    - `attributes` CaseViewAttributes, required: Attributes of a case view, including the filter query and optional notification rule.
      - `created_at` string, date-time, required: Timestamp when the view was created.
      - `modified_at` string, date-time: Timestamp when the view was last modified.
      - `name` string, required: A human-readable name for the view, displayed in the Case Management UI.
      - `np_rule_id` string: The identifier of a notification rule linked to this view. When set, users subscribed to the view receive alerts for matching cases.
      - `query` string, required: The search query that determines which cases appear in this view. Uses the same syntax as the Case Management search bar (for example, `status:open priority:P1`).
    - `id` string, required: The view's identifier.
    - `relationships` CaseViewRelationships: Related resources for the case view, including the creator, last modifier, and associated project.
      - `created_by` NullableUserRelationship, nullable: Relationship to user.
        - `data` NullableUserRelationshipData, nullable, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'user', required: User resource type.
      - `modified_by` NullableUserRelationship, nullable: Relationship to user.
        - `data` NullableUserRelationshipData, nullable, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'user', required: User resource type.
      - `project` ProjectRelationship: Relationship to project.
        - `data` ProjectRelationshipData, required: Relationship to project object.
          - `id` string, required: A unique identifier that represents the project.
          - `type` 'project', required: Project resource type.
    - `type` 'view', required: JSON:API resource type for case views.

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