Get dataset

 

Updated: September 13, 2017



Request | Response | Example | Try on Apiary | Client and web app samples

The Get Dataset operation returns a JSON list of a Dataset entity.

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

To set the permissions scope, see Register an app.

GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}

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}/datasets/{dataset_id}

Uri parameter

NameDescriptionData Type
group_idGuid of the app workspace 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

Authorization: Bearer eyJ0eX ... FWSXfwtQ

Status code

CodeDescription
200OK. Indicates success. The dataset is returned in the response body.

Content-Type

application/json

Body schema

{
  "id": "{dataset_id}",
  "name": "{dataset_name}",
  "addRowsAPIEnabled": {true|false},
  "configuredBy": "{user UPN}",
  "isRefreshable": {true|false},
  "isEffectiveIdentityRequired": {true|false},
  "isEffectiveIdentityRolesRequired": {true|false},
  "isOnPremGatewayRequired": {true|false}
}

Show: