List organizations
GET/api/v1/orgs
Retrieve organizations in multiple formats:
- Paged results (
default) - Flat list (
view=list) - Hierarchical tree (
view=tree)
Parameters
parentOrgId(Guid, optional): retrieve sub-organizations under a specific parent.view(enum, optional): "list", "tree", or "page" (default).skipCount,maxResultCount,sorting: standard paging/sorting fields.sorting: Sorting criteria in the format: 'PropertyName ASC|DESC'. Available properties: name, id.
Responses
-
200 OK: the shape depends onview.pagereturnsitemsandtotalCount.listreturnsitemsonly, withouttotalCount.treereturns an array of root organizations, and each node lists its sub-organizations inchildren. Security -
This API requires authentication.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
OK
Bad Request
Unauthorized
Forbidden
Not Found
Internal Server Error