Getting Organization
You can get information about Microsoft 365 and on-premises Microsoft organizations.
To use this resource, make sure to obtain a token using the same credentials that were used to add the organization instead of credentials of an administrative account. For more information on how to obtain a token, see Authorization for Organizations with Modern Authentication and Legacy Protocols or Basic Authentication.
Request
GET https://<hostname>:4443/v6/Organization |
Request Headers
The request header must contain an authorization token of the current session.
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
The response body contains the following properties:
Property | Type | Description |
---|---|---|
id | string | Specifies the ID of the organization added to Veeam Backup for Microsoft 365. |
name | string | Specifies the name of the Microsoft 365 organization. |
type | string | Specifies the organization type. The following types are available:
|
isBackedup | boolean | If set to true, indicates that this organization had already been processed by a backup job. |
firstBackuptime | UTC | Specifies the time when this organization was processed by a backup job for the first time. |
lastBackuptime | UTC | Specifies the time when this organization was processed by a backup job for the last time. |
_actions | Dictionary of string [key] and Object [value] | Links to related actions (navigation property). |
Example
The example returns a resource representation of an organization whose credentials are used to authenticate against the Veeam Backup for Microsoft 365 server.
Request: GET https://abc.tech.local:4443/v6/Organization
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "id": "cbc52c37-df7f-4b03-98f3-036e7d4b3127", "name": "abc.onmicrosoft.com", "type": "Office365", "isBackedup": true, "firstBackuptime": "2022-04-12T09:38:27.007029Z", "lastBackuptime": "2022-04-15T12:04:48.860654Z", "_actions": { "explore": { "uri": "v6/organization/explore", "method": "POST" } } } |