---
title: "Search change requests"
method: GET
path: "/api/admin/search/change-requests"
tags: ["Change Requests"]
---

# Search change requests

`GET /api/admin/search/change-requests`

**Enterprise feature**

Search and filter change requests by creator and approver.

## Query parameters

- `createdBy` string
- `requestedApproverId` string
- `state` 'IS:open' | 'IS:closed'
- `offset` integer
- `limit` integer

## Response `200`

changeRequestSearchResponseSchema

- ChangeRequestSearchResponseSchema — Response containing a list of change requests and total count.
  - `changeRequests` ChangeRequestSearchItemSchema[], required — List of change requests matching the search criteria.
    - union — A single change request item in search results.
      - object
        - `id` number, required — Unique identifier for the change request.
        - `title` string — Title of the change request. Only present if a custom title is set for this change request.
        - `environment` string, required — Environment where the change request applies.
        - `project` string, required — Project ID where the change request belongs.
        - `createdBy` object, required — User who created the change request.
          - `id` number, required — Unique identifier of the user.
          - `username` string — Username of the user.
          - `imageUrl` string, uri — Avatar image URL for the user.
        - `createdAt` string, date-time, required — Date and time when the change request was created.
        - `features` string[], required — List of feature names affected by this change request.
        - `segments` string[], required — List of segment names affected by this change request.
        - `state` 'Draft' | 'Approved' | 'In review' | 'Applied' | 'Rejected' | 'Cancelled', required — The current state of the change request.
      - object
        - `id` number, required — Unique identifier for the change request.
        - `title` string — Title of the change request. Only present if a custom title is set for this change request.
        - `environment` string, required — Environment where the change request applies.
        - `project` string, required — Project ID where the change request belongs.
        - `createdBy` object, required — User who created the change request.
          - `id` number, required — Unique identifier of the user.
          - `username` string — Username of the user.
          - `imageUrl` string, uri — Avatar image URL for the user.
        - `createdAt` string, date-time, required — Date and time when the change request was created.
        - `features` string[], required — List of feature names affected by this change request.
        - `segments` string[], required — List of segment names affected by this change request.
        - `state` 'Scheduled', required — The current state of the change request.
        - `schedule` union, required — A schedule for a change request's application. The schedule can either be pending, failed, or suspended. The schedule will always contain the state of the schedule and the last scheduled time, but other data varies between the different states.
          - object — A pending schedule for a change request.
            - `scheduledAt` string, date-time, required — When this change request will be applied.
            - `status` 'pending', required — The status of the schedule.
          - object — A failed schedule for a change request.
            - `scheduledAt` string, date-time, required — When Unleash last attempted to apply this change request.
            - `status` 'failed', required — The status of the schedule.
            - `reason` string, required — The reason the scheduled failed to apply.
            - `failureReason` string, nullable — The reason the scheduled failed to apply. Deprecated in favor of the `reason` property.
          - object — A suspended schedule for a change request.
            - `scheduledAt` string, date-time, required — When Unleash would have attempted to apply this change request if the schedule was not suspended.
            - `status` 'suspended', required — The status of the schedule.
            - `reason` string, required — Why the schedule was suspended.
  - `total` number, required — Total number of change requests matching the search criteria.

## Other responses

- `401` — Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.
- `403` — The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation
- `404` — The requested resource was not found.

---

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