api-entities-list.md

title	description	ms.date	ms.topic
List - Entities API	This article describes the list request in the Defender for Cloud Apps Entities API.	01/29/2023	reference

List - Entities API

Note

This request is not available for Microsoft 365 Cloud App Security.

Run the GET or POST request to fetch a list of entities matching the specified filters.

HTTP request

GET /api/v1/entities/

POST /api/v1/entities/

Request BODY parameters

Parameter	Description
filters	Filter objects with all the search filters for the request, for more details see entity filters
sortDirection	The sorting direction. Possible values are: asc and desc
sortField	Fields used to sort entities. Possible values are: - date: The date when then the entity was created - severity: The severity of the entity
skip	Skips the specified number of records
limit	Maximum number of records returned by the request

Example

Request

Here's an example of the request.

curl -XPOST -H "Authorization:Token <your_token_key>" -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/entities/" -d '{
  "filters": {
    // some filters
  },
  "skip": 5,
  "limit": 10
  ...
}'

Response

Returns a list of activities in JSON format.

{
  "total": 5 // approximate number of records
  "hasNext": true // whether there is more data to show or not.
  "data": [
    // returned records
  ]
}

[!INCLUDE Open support ticket]