Getting Teams
You can get a resource representation of an organization teams.
Request
GET https://<hostname>:4443/v6/Organizations/{organizationId}/Teams |
Request Headers
The request header must contain an authorization token of the current session.
Request Parameters
The following parameter must be specified in the URL of the request:
Parameter | Type | Description |
---|---|---|
organizationId | string | Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Getting Organizations. |
The following optional parameter can be specified in the URL of the request:
Parameter | Type | Description |
---|---|---|
displayName | string | Specifies a display name of the team. |
Request Body
None.
Response
The server returns the following response to the client.
Response Codes
A successfully completed operation returns a response code 200 OK.
Response Headers
The response to this request contains the following headers. The response may also include additional standard HTTPS headers.
Header | Description |
---|---|
Content-length | The length of the response body. |
Content-type | The media type and syntax of the response body message: application/json; charset=utf-8 |
Response Body
In the response body, the server returns a resource representation of the /Organizations/{organizationId}/Teams collection resource.
Example
The example returns a list of teams for an organization with the specified ID.
Request: GET https://abc.tech.local:4443/v6/Organizations/e60dfb9c-ac58-4463-879f-9855ac35576b/Teams
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "offset": 0, "limit": 30, "_links": { "self": { "href": "/v6/Organizations/e60dfb9c-ac58-4463-879f-9855ac35576b/Teams?offset=0&limit=30&setid=346cfafd-dbc3-4113-b0e8-89a59ea3f73b" } }, "results": [ { "id": "2f515ce6-f1b5-49e9-9e7d-b1cef405f3c4", "displayName": "Team A", "description": "", "mail": "team_a@abc.onmicrosoft.com", "_links": { "self": { "href": "/v6/organizations/e60dfb9c-ac58-4463-879f-9855ac35576b/teams/2f515ce6-f1b5-49e9-9e7d-b1cef405f3c4" }, "organization": { "href": "/v6/organizations/e60dfb9c-ac58-4463-879f-9855ac35576b" } } }, { "id": "39b8d5ce-661b-40c3-b836-b49400da183a", "displayName": "Team B", "description": "", "mail": "team_b@abc.onmicrosoft.com", "_links": { "self": { "href": "/v6/organizations/e60dfb9c-ac58-4463-879f-9855ac35576b/teams/39b8d5ce-661b-40c3-b836-b49400da183a" }, "organization": { "href": "/v6/organizations/e60dfb9c-ac58-4463-879f-9855ac35576b" } } }, { "id": "ef956661-a3f1-4e60-8970-1ed6435422b4", "displayName": "Team C", "description": "", "mail": "team_c@abc.onmicrosoft.com", "_links": { "self": { "href": "/v6/organizations/e60dfb9c-ac58-4463-879f-9855ac35576b/teams/ef956661-a3f1-4e60-8970-1ed6435422b4" }, "organization": { "href": "/v6/organizations/e60dfb9c-ac58-4463-879f-9855ac35576b" } } }, ... ], "setId": "346cfafd-dbc3-4113-b0e8-89a59ea3f73b" } |