Get Imports

 

Updated: July 21, 2017

Request | Response

The Get Imports operation returns a JSON list of all Import objects with there properties including id, import source, Reports, and Datasets.

Required scope: Dataset.Read.All or Dataset.ReadWrite.All

GET https://api.powerbi.com/v1.0/myorg/imports

Groups

Groups are a collection of unified Azure Active Directory groups that the user is a member of and is available in the Power BI service. These are referred to as app workspaces within the Power BI service. To learn how to create a group, see Create an app workspace.

GET https://api.powerbi.com/v1.0/myorg/groups/{group_id}/imports

Uri parameter

NameDescriptionData Type
group_idGuid of the Group to use. You can get the group id from the Get Groups operation. Groups are referred to as app workspaces within the Power BI service.String

Header

Content-Type: application/json
Authorization: Bearer eyJ0eX ... FWSXfwtQ

Status code

CodeDescription
200OK. Indicates success. The response body contains datasets for imported files, and reports for connected files.

Content-Type

application/json

Body schema

Imports have the following properties:

  • Id
  • Name
  • createdDateTime
  • Import source (either file or URL path)
  • Array of Reports
    • A Report has the same properties as returned by GET Reports.
  • Array of Datasets
    • A Dataset has the same properties as returned by GET Datasets.
Copy 
{  
"value":[  
    {  
      "id" : "{guid}",  
      "createdDateTime" : "{DateTime}",  
    "reports" : [  
    {  
      "id":"{guid}",  
      "name":"{string}"  
    }    
    ],  
    "datasets" : [  
    {  
      "id":"{guid}",  
      "name":"{string}"  
    }    
    ]  
    }  
  ]      
}

Body Example

Copy 
{  
"value":[  
    {  
      "id" : "405BBEEB--30264301ED95",  
      "createdDateTime" : "2015-03-13 15:51:30.937",  
    "reports" : [  
    {  
      "id":"1662698F-045D-4F2D-AFD1-556BEC8F4413",  
      "name":"forecast.xlsx"  
    }    
    ],  
    "datasets" : [  
    {  
      "id":"A68F51BD--5EFF229013C7",  
      "name":"forecast.xlsx"  
    }    
    ]  
    }  
  ]      
}
Show: