---
updatedAt: 2026-05-21T16:42:26.000Z
---

# Gets the list of all the operations that are performed on accounts of this tenant.

Entitlements required:  manageAppAccessAdmin  (Manage application lifecycle), manageAppAccessOwner (Manage application entitlements), readAppConfig (Read Application Configuration)

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0.0",
    "description": "Lifecycle & Governance",
    "title": "Lifecycle & Governance"
  },
  "servers": [
    {
      "url": "https://{tenanturl}",
      "variables": {
        "tenanturl": {
          "default": "{tenant_url}",
          "description": "URL of your IBM Security Verify tenant"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Account Lifecycle"
    }
  ],
  "paths": {
    "/v1.0/accounts/operations": {
      "get": {
        "tags": [
          "Account Lifecycle"
        ],
        "summary": "Gets the list of all the operations that are performed on accounts of this tenant.",
        "description": "Entitlements required:  manageAppAccessAdmin  (Manage application lifecycle), manageAppAccessOwner (Manage application entitlements), readAppConfig (Read Application Configuration)",
        "operationId": "searchOperations",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "description": "Search query to filter the operation records. It can be based on `type` and `status` fields. Free text search is also supported.\n\n Examples:\n\n 1. \"type=AP\" - Get all operations of type account provisioning\n\n 2. \"status=FAILED\" - Get all failed operations\n\n 3. \"type=AR&status=SUCCESS\" - Get all successful account restore operations.\n\n 4. \"q=John\" - Get all operation entries with text matching John in the application name or account username filed.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Attribute to sort the results. Supported attributes are:\n\n 1. lastUpdatedTime: Timestamp when operation record was last updated\n\n 2. account userName: account username (Default).\n\n Specify `-` before the attribute for descending results",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request is Successful.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchOperationBean"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseBean"
                }
              }
            }
          },
          "401": {
            "description": "User not Authorised.",
            "content": {}
          }
        },
        "x-category": "Lifecycle & Governance",
        "x-publicAPI": "true"
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorResponseBean": {
        "required": [
          "messageDescription"
        ],
        "type": "object",
        "properties": {
          "messageId": {
            "type": "string",
            "description": "Unique identifier associated with the message."
          },
          "messageDescription": {
            "type": "string",
            "description": "Text describing the error message."
          }
        }
      },
      "AccountOwnerBean": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for account owner"
          },
          "name": {
            "type": "string",
            "description": "name of account owner"
          }
        }
      },
      "MessageBean": {
        "required": [
          "description",
          "status"
        ],
        "type": "object",
        "properties": {
          "description": {
            "type": "string",
            "description": "Detailed message about the current state of operation."
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the operation",
            "format": "int32"
          },
          "details": {
            "$ref": "#/components/schemas/MessageDetailsBean"
          }
        }
      },
      "MessageDetailsBean": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "integer",
            "description": "HTTP status sent by the underlying target",
            "format": "int32"
          },
          "error": {
            "type": "string",
            "description": "Error details sent by the target"
          },
          "message": {
            "type": "string",
            "description": "Details about the error message"
          }
        }
      },
      "OperationBean": {
        "required": [
          "accountName",
          "accountOwner",
          "applicationName",
          "gracePeriod",
          "icon",
          "id",
          "lastUpdatedTime",
          "message",
          "origin",
          "requestor",
          "status",
          "submissionTime",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for the operation."
          },
          "type": {
            "type": "string",
            "description": "The type of the operation",
            "enum": [
              "AP (Account Provisioning)",
              "AD (Account Deprovisioning)"
            ]
          },
          "origin": {
            "type": "string",
            "description": "Information on from where the operation originated",
            "enum": [
              "AM (Automatic)",
              "MN (Manual)"
            ]
          },
          "applicationName": {
            "type": "string",
            "description": "Name of the application whose account is operated"
          },
          "icon": {
            "type": "string",
            "description": "URL to fetch the icon for the application"
          },
          "accountName": {
            "type": "string",
            "description": "Name of the account on which operation is performed"
          },
          "lastUpdatedTime": {
            "type": "integer",
            "description": "When was the operation last updated",
            "format": "int64"
          },
          "status": {
            "type": "string",
            "description": "Status of operation"
          },
          "accountOwner": {
            "$ref": "#/components/schemas/AccountOwnerBean"
          },
          "requestor": {
            "$ref": "#/components/schemas/RequestorBean"
          },
          "message": {
            "$ref": "#/components/schemas/MessageBean"
          },
          "submissionTime": {
            "type": "integer",
            "description": "When was the operation was submitted",
            "format": "int64"
          },
          "gracePeriod": {
            "type": "integer",
            "description": "Graceperiod",
            "format": "int64"
          },
          "permissionType": {
            "type": "string",
            "description": "Type of permission associated with the operation, if any"
          },
          "permissionId": {
            "type": "string",
            "description": "ID of permission associated with the operation, if any"
          },
          "permissionName": {
            "type": "string",
            "description": "Name of permission associated with the operation, if any"
          },
          "modifiedAttributes": {
            "type": "string",
            "description": "List of modified attributes"
          }
        }
      },
      "RequestorBean": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the user who requested the operation"
          },
          "name": {
            "type": "string",
            "description": "name of user"
          }
        }
      },
      "SearchOperationBean": {
        "required": [
          "operations",
          "totalCount"
        ],
        "type": "object",
        "properties": {
          "totalCount": {
            "type": "integer",
            "description": "Total number of records found.",
            "format": "int32"
          },
          "operations": {
            "type": "array",
            "description": "List of all the operations performed.",
            "items": {
              "$ref": "#/components/schemas/OperationBean"
            }
          },
          "supportedOpTypesForRetry": {
            "type": "array",
            "description": "List of all operation codes that can be retried like 'AP', 'AD', 'AGA', 'RGA', 'AM', 'AS', 'AR'.",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  },
  "x-original-swagger-version": "2.0",
  "x-explorer-enabled": false
}
```