---
title: "Get a change request"
method: GET
path: "/api/v2/change-management/change-request/{change_request_id}"
tags: ["Change Management"]
---

# Get a change request

`GET /api/v2/change-management/change-request/{change_request_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/change-management/change-request/{change_request_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`

Get the details of a change request by its ID.

## Path parameters

- `change_request_id` string, required

## Response `200`

OK

- ChangeRequestResponse: Response object for a change request.
  - `data` ChangeRequestResponseData, required: Data object for a change request response.
    - `attributes` ChangeRequestResponseAttributes, required: Attributes of a change request response.
      - `archived_at` string, date-time, nullable: Timestamp of when the change request was archived.
      - `attributes` ChangeRequestObjectAttributes, required: Custom attributes of the change request as key-value pairs.
      - `change_request_linked_incident_uuid` string, required: The UUID of the linked incident.
      - `change_request_maintenance_window_query` string, required: The maintenance window query for the change request.
      - `change_request_plan` string, required: The plan associated with the change request.
      - `change_request_risk` 'UNDEFINED' | 'LOW' | 'MEDIUM' | 'HIGH', required: The risk level of the change request.
      - `change_request_type` 'NORMAL' | 'STANDARD' | 'EMERGENCY', required: The type of the change request.
      - `closed_at` string, date-time, nullable: Timestamp of when the change request was closed.
      - `created_at` string, date-time, required: Timestamp of when the change request was created.
      - `creation_source` string, required: The source from which the change request was created.
      - `description` string, required: The description of the change request.
      - `end_date` string, date-time: The planned end date of the change request.
      - `key` string, required: The human-readable key of the change request.
      - `modified_at` string, date-time, required: Timestamp of when the change request was last modified.
      - `plan_notebook_id` integer, required: The notebook ID associated with the change request plan.
      - `priority` string, required: The priority of the change request.
      - `project_id` string, required: The project UUID associated with the change request.
      - `start_date` string, date-time: The planned start date of the change request.
      - `status` string, required: The current status of the change request.
      - `title` string, required: The title of the change request.
      - `type` string, required: The case type.
    - `id` string, required: The identifier of the change request.
    - `relationships` ChangeRequestRelationships: Relationships of a change request.
      - `change_request_decisions` ChangeRequestDecisionsRelationship, required: Relationship to change request decisions.
        - `data` ChangeRequestDecisionRelationshipData[], required: Array of decision relationship data.
          - `id` string, required: The decision UUID.
          - `type` 'change_request_decision', required: Change request decision resource type.
      - `created_by` ChangeRequestUserRelationship, required: Relationship to a user.
        - `data` ChangeRequestUserRelationshipData, nullable, required: User relationship data.
          - `id` string, required: The user UUID.
          - `type` string, required: The user resource type.
      - `modified_by` ChangeRequestUserRelationship, required: Relationship to a user.
        - `data` ChangeRequestUserRelationshipData, nullable, required: User relationship data.
          - `id` string, required: The user UUID.
          - `type` string, required: The user resource type.
    - `type` 'change_request', required: Change request resource type.
  - `included` ChangeRequestIncludedItem[]: Included resources related to the change request.
    - union: An included resource item in the change request response.
      - ChangeRequestIncludedUser: An included user resource.
        - `attributes` ChangeRequestIncludedUserAttributes, required: Attributes of an included user.
          - `email` string, required: The email of the user.
          - `handle` string, required: The handle of the user.
          - `name` string, required: The name of the user.
        - `id` string, required: The user UUID.
        - `type` string, required: The resource type.
      - ChangeRequestIncludedDecision: An included change request decision resource.
        - `attributes` ChangeRequestDecisionResponseAttributes, required: Attributes of a change request decision in a response.
          - `change_request_status` 'REQUESTED' | 'APPROVED' | 'DECLINED', required: The status of a change request decision.
          - `decided_at` string, date-time, required: Timestamp of when the decision was made.
          - `decision_reason` string, required: The reason for the decision.
          - `deleted_at` string, date-time, required: Timestamp of when the decision was deleted.
          - `request_reason` string, required: The reason for requesting the decision.
          - `requested_at` string, date-time, required: Timestamp of when the decision was requested.
        - `id` string, required: The decision UUID.
        - `relationships` ChangeRequestDecisionRelationships: Relationships of a change request decision.
          - `modified_by` ChangeRequestUserRelationship, required: Relationship to a user.
            - `data` ChangeRequestUserRelationshipData, nullable, required: User relationship data.
              - …
          - `requested_by_user` ChangeRequestUserRelationship, required: Relationship to a user.
            - `data` ChangeRequestUserRelationshipData, nullable, required: User relationship data.
              - …
          - `requested_user` ChangeRequestUserRelationship, required: Relationship to a user.
            - `data` ChangeRequestUserRelationshipData, nullable, required: User relationship data.
              - …
        - `type` 'change_request_decision', required: Change request decision resource type.

## Other responses

- `400`: Bad Request
- `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)