Get all the organizations.
get
/iam/governance/selfservice/api/v1/organizations
Returns the organizations assigned to the logged in user. The filter query parameter can be used to return a subset of the organizations. SCIM filter is accepted. For example The query to get all organizations whose name starts with Oracle is /organization?q=name sw Oracle. The attributes that are to be returned by the organization can also be controlled by specifying the attributes query parameter. A Comma-separated list of the attribute names is to be passed to the attribbutes query parameter. For example to get the organization name and description only the URI is "/organization?fields=name, description.
Request
Supported Media Types
- application/json
Query Parameters
-
fields(optional): string
The attributes that are to be returned by the organization can also be controlled by specifying the attributes query parameter. A Comma-separated list of the attribute names is to be passed to the attributes query parameter. For example to get the organization name and description only the URI is "/organization?fields=name, description.
-
q(optional): string
Filter can be applied for "entityType" for that possible value is - Role and "roleid" for that organizations is retrieved. here should not be any spaces for filter value. Sample value for filter is "entityType eq Role" or "entityType eq Role and roleid={roleId}".
Response
Supported Media Types
- application/json
200 Response
Successful
Headers
-
ResponseTime: string
Captures the time in milliseconds taken for processing the request.
401 Response
Unauthorized
404 Response
Resource not found
500 Response
Internal Server Error
Default Response
Unexpected error
Examples
This example retrieves all organizations.. The information shown here is against a pseudo system and serves as a prototype.
cURL Example
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/organization
Example of GET Response Body
The following example shows the contents of the response body in JSON format.
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/organizations"
}
],
"count": 2,
"organization": [
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/organizations/5"
}
],
"id": 5,
"fields": {
"Certifier User Key": null,
"Applicable Password Policy": 1,
"Certifier User Login": null,
"Organization Status": "Active",
"Parent Organization Name": "Top",
"Organization Name": "Org2",
"act_updateby": 1,
"act_key": 5,
"Password Policy": null,
"Organization Customer Type": "Company",
"Password Policy Name": null,
"parent_key": 3,
"User Membership Rule": null,
"act_createby": 1,
"act_create": 1456833264000,
"act_data_level": null,
"act_update": 1456833264000,
"Applicable Password Policy Name": null,
"Enforce New Password Policy": "Yes",
"act_disabled": null
}
},
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/organizations/4"
}
],
"id": 4,
"fields": {
"Certifier User Key": null,
"Applicable Password Policy": 1,
"Certifier User Login": null,
"Organization Status": "Active",
"Parent Organization Name": "Top",
"Organization Name": "Org1",
"act_updateby": 1,
"act_key": 4,
"Password Policy": null,
"Organization Customer Type": "Company",
"Password Policy Name": null,
"parent_key": 3,
"User Membership Rule": null,
"act_createby": 1,
"act_create": 1456819726000,
"act_data_level": null,
"act_update": 1456819726000,
"Applicable Password Policy Name": null,
"Enforce New Password Policy": "Yes",
"act_disabled": null
}
}
]
}