You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
32
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
33
33
34
34
> Want to experience Microsoft Defender Vulnerability Management? Find out how to [sign up for a free trial](/defender-vulnerability-management/get-defender-vulnerability-management).
35
35
@@ -52,7 +52,7 @@ For an example of OData operation usage, see [example $top request](#example-top
52
52
53
53
## Limitations
54
54
55
-
1. Rate limitations for this API are 100 calls per minute and 1500 calls per hour.
55
+
1. Rate limitations for this API are 100 calls per minute and 1,500 calls per hour.
56
56
57
57
## Permissions
58
58
@@ -63,10 +63,7 @@ One of the following permissions is required to call this API. To learn more, in
63
63
|Application|Machine.Read.All| Read all scan information.|
64
64
|Delegated (work or school account)|Machine.Read.All|Read all scan information.|
65
65
66
-
> [!NOTE]
67
-
> When obtaining a token using user credentials:
68
-
> - To view data the user needs to have at least the following role permission: 'ViewData' or 'TvmViewData' (See [Create and manage roles](../user-roles.md) for more information)
69
-
>
66
+
When obtaining a token using user credentials, to view data, the user needs to have at least the following role permission: `ViewData` or `TvmViewData` (See [Create and manage roles](../user-roles.md)).
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
32
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
33
33
34
34
> Want to experience Microsoft Defender Vulnerability Management? Learn more about how you can sign up to the [Microsoft Defender Vulnerability Management public preview trial](/defender-vulnerability-management/get-defender-vulnerability-management).
Copy file name to clipboardExpand all lines: defender-endpoint/api/get-machine-related-alerts.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ ms.date: 12/18/2020
26
26
-[Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
27
27
-[Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
28
28
29
-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
29
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
30
30
31
31
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
Copy file name to clipboardExpand all lines: defender-endpoint/api/get-machineaction-object.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ ms.date: 12/18/2020
26
26
-[Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
27
27
-[Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
28
28
29
-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
29
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
30
30
31
31
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
Copy file name to clipboardExpand all lines: defender-endpoint/api/get-machineactions-collection.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ ms.date: 12/18/2020
27
27
-[Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
28
28
-[Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
29
29
30
-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
30
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
31
31
32
32
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
Copy file name to clipboardExpand all lines: defender-endpoint/api/get-machines-by-software.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ ms.date: 12/18/2020
27
27
-[Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
28
28
-[Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
29
29
30
-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
30
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
31
31
32
32
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
Copy file name to clipboardExpand all lines: defender-endpoint/api/get-machines.md
+9-11Lines changed: 9 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,15 +26,15 @@ ms.date: 04/17/2024
26
26
-[Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
27
27
-[Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
28
28
29
-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
29
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
30
30
31
31
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
@@ -47,7 +47,7 @@ See examples at [OData queries with Defender for Endpoint](exposed-apis-odata-sa
47
47
48
48
- You can get devices last seen according to your configured retention period.
49
49
- Maximum page size is 10,000.
50
-
- Rate limitations for this API are 100 calls per minute and 1500 calls per hour.
50
+
- Rate limitations for this API are 100 calls per minute and 1,500 calls per hour.
51
51
52
52
## Permissions
53
53
@@ -58,13 +58,11 @@ Application|Machine.ReadWrite.All|'Read and write all machine information'
58
58
Delegated (work or school account)|Machine.Read|'Read machine information'
59
59
Delegated (work or school account)|Machine.ReadWrite|'Read and write machine information'
60
60
61
-
> [!NOTE]
62
-
> When obtaining a token using user credentials:
63
-
>
64
-
> - The user needs to have at least the following role permission: 'View Data' (For more information, see [Create and manage roles](../user-roles.md))
65
-
> - Response will include only devices, that the user have access to, based on device group settings (For more information, see [Create and manage device groups](../machine-groups.md))
66
-
>
67
-
> Device group creation is supported in Defender for Endpoint Plan 1 and Plan 2.
61
+
When obtaining a token using user credentials, the user needs to have at least the following role permission: `View Data` (see [Create and manage roles](../user-roles.md)).
62
+
63
+
Responses include only devices that the user has access to, based on device group settings (See [Create and manage device groups](../machine-groups.md)).
64
+
65
+
Device group creation is supported in Defender for Endpoint Plan 1 and Plan 2.
68
66
69
67
## HTTP request
70
68
@@ -84,7 +82,7 @@ Empty
84
82
85
83
## Response
86
84
87
-
If successful and machines exists - 200 OK with list of [machine](machine.md) entities in the body. If no recent machines - 404 Not Found.
85
+
If successful, and the machines exist, you see `200 OK` with list of [machine](machine.md) entities in the body. If there are no recent machines, you see `404 Not Found`.
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
31
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
32
32
33
33
> Want to experience Microsoft Defender Vulnerability Management? Learn more about how you can sign up to the [Microsoft Defender Vulnerability Management public preview trial](/defender-vulnerability-management/get-defender-vulnerability-management).
Copy file name to clipboardExpand all lines: defender-endpoint/api/get-missing-kbs-software.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ ms.date: 12/18/2020
27
27
-[Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
28
28
-[Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
29
29
30
-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
30
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
31
31
32
32
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
Copy file name to clipboardExpand all lines: defender-endpoint/api/get-package-sas-uri.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ ms.date: 04/17/2024
26
26
-[Microsoft Defender for Endpoint Plan 1](../microsoft-defender-endpoint.md)
27
27
-[Microsoft Defender for Endpoint Plan 2](../microsoft-defender-endpoint.md)
28
28
29
-
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
29
+
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630&clcid=0x409&culture=en-us&country=us)
30
30
31
31
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
0 commit comments