Reports - Get Export To File Status In Group

Service:: Power BI REST APIs

API Version:: v1.0

Returns the current status of the Export to File In Group job for the specified report from the specified workspace.

When the export job status is 'Succeeded' use the GetFileOfExportToFile API to retrieve the file.

Permissions

This API call can be called by a service principal profile. For more information see: Service principal profiles in Power BI Embedded.

Required Scope

Report.ReadWrite.All or Report.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/exports/{exportId}

URI Parameters

Name	In	Required	Type	Description
exportId	path	True	string	The export ID
groupId	path	True	string (uuid)	The workspace ID
reportId	path	True	string (uuid)	The report ID

Responses

Name	Type	Description
200 OK	Export	OK
202 Accepted	Export	Accepted

Examples

Example

Sample request

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/exports/{exportId}

Sample response

Status code:: 200

{
  "id": "Mi9C5419i....PS4=",
  "createdDateTime": "2021-12-08T10:26:09.3069086Z",
  "lastActionDateTime": "2021-12-08T10:26:38.016851Z",
  "reportId": "cad51cfa-e740-324f-acbb-8ca43c40a2d4",
  "reportName": "Report name",
  "status": "Succeeded",
  "percentComplete": 100,
  "resourceLocation": "...Mi9C5419i....PS4=/file",
  "resourceFileExtension": ".pptx",
  "expirationTime": "2021-12-09T10:26:11.586756Z"
}

Definitions

Name	Description
Export	An object describing the details and current state of an export to file job
ExportState	The current state of the export to file job

Export

Object

An object describing the details and current state of an export to file job

Name	Type	Description
createdDateTime	string (date-time)	The start date and time of the export to file job
expirationTime	string (date-time)	The expiration date and time of the retrieval URL
id	string	The export to file job ID
lastActionDateTime	string (date-time)	The date and time of the last change to the export to file job
percentComplete	integer (int32) minimum: 0 maximum: 100	Job progress as a percentage
reportId	string (uuid)	The ID of the exported report
reportName	string	The name of the exported report
resourceFileExtension	string	The extension of the exported file
resourceLocation	string	The retrieval URL for the exported file
status	ExportState	The current state of the export to file job

ExportState

Enumeration

The current state of the export to file job

Value	Description
Undefined	The state of the export to file job is undefined
NotStarted	The export to file job didn't start
Running	The export to file job is running
Succeeded	The export to file job finished successfully
Failed	The export to file job failed

Share via