Get Change Request Status
Get the status of a change request and its individual line items.
GET https://instance.securid.com/aveksa/command.submit?cmd=getChangeRequestStatus
Request
Parameters
| getChangeRequestStatus | |
| The ID of the change request. | |
| delimiter | The delimiter used to separate fields within a request-item-status entry. Defaults to |. When a request contains more than one change request item, each item is separated by the delimiter repeated twice (e.g. || by default). |
| format |
|
| token | Deprecated. Use the Authorization request header instead. |
Headers
Bearer token | |
| Accept | application/json |
| Content-Type | application/json |
Response
Parameters
overall-status | The overall status of the change request. For example: Pending, InProgress, Completed, Cancelled. |
start-time | The time the request was started. |
request-item-status | A delimited string containing the status of each change request line item. Each item contains four fields separated by the delimiter: itemId, action, status, comments. Multiple items are separated by the delimiter repeated twice. |
completed-time | The time the request completed. Only returned when the request is in a terminal state (Completed or Cancelled). |
Examples
Request
- Curl
- Python
- Node.js
curl -K -X GET \
"https://instance.securid.com/aveksa/command.submit?cmd=getChangeRequestStatus&format=json&id=221" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"
import requests
url = "https://instance.securid.com/aveksa/command.submit"
params = {
"cmd": "getChangeRequestStatus",
"format": "json",
"id": "221"
}
headers = {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
}
response = requests.get(url, params=params, headers=headers)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f"Request failed with status code {response.status_code}")
const axios = require('axios');
const url = "https://instance.securid.com/aveksa/command.submit";
const params = {
cmd: "getChangeRequestStatus",
format: "json",
id: "221"
};
const headers = {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
};
axios.get(url, { params, headers })
.then(response => {
if (response.status === 200) {
console.log(response.data);
} else {
console.log(`Request failed with status code ${response.status}`);
}
})
.catch(error => {
console.error('Error:', error);
});
Response
- 200 Completed
- 200 Cancelled (multiple items)
- 200 Custom delimiter
- 401 Invalid Token
- 412 Missing id
- 412 Invalid id
{
"data": {
"type": "getChangeRequestStatus",
"overall-status": "Completed",
"start-time": "2026-05-15 17:39:21",
"request-item-status": "262|Add|Completed| ",
"completed-time": "2026-05-15 17:40:17"
}
}
{
"data": {
"type": "getChangeRequestStatus",
"overall-status": "Cancelled",
"start-time": "2025-03-07 17:07:09",
"request-item-status": "105|Create|Cancelled| ||110|Create|Cancelled|Triggered automatically by dependent change item||111|Add|Completed| ||112|Add|Completed| ",
"completed-time": "2025-08-17 22:38:35"
}
}
{
"data": {
"type": "getChangeRequestStatus",
"overall-status": "Completed",
"start-time": "2026-05-15 17:39:21",
"request-item-status": "262,Add,Completed, ",
"completed-time": "2026-05-15 17:40:17"
}
}
<html>
<head>
<title>Error</title>
</head>
<body>The token is not valid for the command 'getChangeRequestStatus'. Token is invalid or expired</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>The parameter id is required.
Query String=cmd=getChangeRequestStatus&format=json</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>The change request id '<id>' is invalid, or the user is not allowed to view it.
Query String=cmd=getChangeRequestStatus&format=json&id=<id></body>
</html>
See Also
- Find Change Requests: Search for change requests to retrieve their IDs
- Cancel Change Request: Cancel a pending change request
Verified with RSA Governance & Lifecycle version 8.0.0.188886 P10_HF01.