We’ve renamed Microsoft Cloud App Security. It’s now called Microsoft Defender for Cloud Apps. In the coming weeks, we’ll update the screenshots and instructions here and in related pages. For more information about the change, see this announcement. To learn more about the recent renaming of Microsoft security services, see the Microsoft Ignite Security blog.


  • This API will soon be deprecated. Microsoft Defender for Cloud Apps is developing a new solution for identifying and acting upon files that violate policies.
  • This endpoint may time out when filtering and paginating large collections.
  • This API is not available for Office 365 Cloud App Security.

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

HTTP request


GET /api/v1/files/

POST /api/v1/files/

Request BODY parameters

Parameter Description
filters Filter objects with all the search filters for the request, see file filters for more details
skip Skips the specified number of records
limit Maximum number of records returned by the request



Here is an example of the request.


curl -XPOST -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.contoso.com/api/v1/files/" -d '{
  "filters": {
    // some filters
  "skip": 5,
  "limit": 10


Returns a list of files in JSON format.


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

If you run into any problems, we’re here to help. To get assistance or support for your product issue, please open a support ticket.

Source : Official Microsoft Brand
Editor by : BEST Antivirus KBS Team

How useful was this post?

Click on a star to rate it!

Average rating 0 / 5. Vote count: 0

No votes so far! Be the first to rate this post.