Organizations API

Use the Organizations API to return information about all the EASE organizations on which the authenticated user can operate. This information will include an org_id for each organization. An org_id is the unique identifier that EASE assigns to each organization. If you manage any affiliated (child and grandchild) organizations, you can authenticate through the API as an EASE administrator of a parent organization and send API requests to perform functions in any of the affiliated organizations without having to re-authenticate; this is done by including the org_id in the URL of the request. For more information, see Sending Requests for Affiliated (Child) Organizations.

Resources

GET /v1/organizations/

List Organizations

Returns information about all the organizations on which the authenticated user can operate. If the authenticated user is an EASE administrator (user with the “Administrator” role), the list includes the user’s organization, its parent organization (if there is one) and any affiliated (child and grandchild) organizations. If the user is not an administrator, the list includes the user’s organization only.

The response identifies the org_id for each listed organization. If you are working in an EASE organization that has affiliated organizations, you can include org_id in an API request to perform functions in any of your affiliated organizations without having to re-authenticate. For more information, see Sending Requests for Affiliated (Child) Organizations.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/organizations/
Europe https://eu01ws.apperian.eu/v1/organizations/

URL Parameters

None

Header Parameters

X-TOKEN
(Required) Session token returned by POST /users/authenticate.

Data Parameters

None

Example Request

The following cURL request returns information about the authenticated user’s organization, the parent organization, and the two affiliated organizations (sub_orgs).

curl -X GET https://eu01ws.apperian.eu/v1/organizations/ --header "X-TOKEN:OxS8iqSHSSmRqcqQ1pXXwg"

Example Response

{
  "parent_id": null,
  "name": "HoneyBee's Organic Honey",
  "id": "Aegm9Dfmsbb4dSxpt8lZTjA",
  "sub_orgs": [
    {
      "sub_orgs": [],
      "parent_id": "Aegm9Dfmsb34dSxpt8lZTjA",
      "name": "Honey From the West",
      "id": "XTBEV_SGPlI0oI8ozGTh0A"
    },
    {
      "sub_orgs": [],
      "parent_id": "Aegm9aDfmsb4dSxpt8lZTjA",
      "name": "Honey from the East",
      "id": "Vj9lkP0txgod4BMIyzMvxQ"
    }
  ]
}