Organization API REST Endpoints
Organization API
The STS Gen2 Organization API is used to interact with organizations, locations, and revenue centers within the organization. It also provides a search capability to support the ability to find locations in an organization or revenue centers within a single location based on geographic location.
Paths
| Resource | Base path |
|---|---|
| Organization API | https://host/api/v1/ |
The Organization API provides access to organizations, locations, and revenue center resources.
An organization has one or more locations, and each location has one more revenue centers. The identifier for an organization in the API is orgShortName, the identifier for a location in the API is locRef, and the identifier for a revenue center in the API is rvcRef. The identifiers for locations are not unique across all organizations and similarly the identifiers for revenue centers are not unique across all locations within an organization. Since there is no uniqueness the path to access each of the resources must include its parent resource. For this reason, we end up with the following paths to GET each resource.
- Get a list of all locations for an organization
- Method: getPath:
/api/v1/organizations/{orgShortName}/locations - Get a list of all revenue centers for a location
- Method: getPath:
/api/v1/organizations/{orgShortName}/locations/{locRef}/revenueCenters - Get a list of organizations
- Method: getPath:
/api/v1/organizations - Get a location by the specified identifier for an organization
- Method: getPath:
/api/v1/organizations/{orgShortName}/locations/{locRef} - Get a revenue center by the specified identifier for a location
- Method: getPath:
/api/v1/organizations/{orgShortName}/locations/{locRef}/revenueCenters/{rvcRef} - Get an organization by the specified identifier
- Method: getPath:
/api/v1/organizations/{orgShortName} - Get search for locations within an organization
- Method: getPath:
/api/v1/search/locations - Get search for revenue centers within a location
- Method: getPath:
/api/v1/search/revenueCenters