Search change requests | Unleash Documentation

import requests
url = "https://app.unleash-instance.example.com/api/admin/search/change-requests"
headers = {"Authorization": "<apiKey>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "changeRequests": [
    {
      "id": 1368,
      "title": "Increase rollout to 65%",
      "environment": "production",
      "project": "dx",
      "createdBy": {
        "id": 42,
        "username": "Tymek Czech",
        "imageUrl": "https://gravatar.com/avatar/8f5a1ce5f210eb56f8d9a2ba1a5940c224c916d5e91159d4036fb46cc6d059dd?s=42&d=retro&r=g"
      },
      "createdAt": "2025-04-30T13:04:48.482Z",
      "features": [
        "feature-a",
        "feature-b"
      ],
      "segments": [
        "segment-a",
        "segment-b"
      ],
      "state": "Applied"
    }
  ],
  "total": 42
}

Enterprise feature

Search and filter change requests by creator and approver.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

API key needed to access this API, in Bearer token format

Query parameters

createdBystringOptional

Filter by change request creator user ID

requestedApproverIdstringOptional

Filter by requested approver user ID

stateenumOptional

Filter by open / closed change requests. Change requests that are in ‘draft’, ‘in review’, ‘approved’, or ‘scheduled’ states are considered open. Change requests that are in ‘cancelled’, ‘applied’, or ‘rejected’ states are considered closed.

Allowed values:

offsetintegerOptional>=0Defaults to 0

The number of change requests to skip when returning a page. By default it is set to 0.

limitintegerOptional1-1000Defaults to 50

The number of change requests to return in a page. By default it is set to 50. The maximum is 1000.

Response

changeRequestSearchResponseSchema

changeRequestslist of objects

List of change requests matching the search criteria.

totaldouble

Total number of change requests matching the search criteria.

Authentication

Query parameters

Response

Errors