# Instances List

Returns a list of instances for a report that you requested to be run asynchronously. Each item in the list is treated as a separate instance of the report run with metadata in that snapshot of time.

## Resource URL

```nolang
/services/data/<latest API version>/analytics/reports/<report ID>/instances
```

## Formats

JSON

## HTTP Methods

| Method | Description                                                                                                                                                                |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET    | Return a list of asynchronous runs of a report. See this [example](/docs/analytics/salesforce-analytics-rest-api/guide/sforce-analytics-rest-api-list-asyncreportruns.md). |

## Response Body

| Property         | Type              | Description                                                                                                                                                                                                                                                                                                                  |
| ---------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`             | String            | Unique ID for a report instance that was requested for a run. The ID is used to obtain results of the report run for that instance.                                                                                                                                                                                          |
| `status`         | String            | New if the report run has just been triggered through a POST request, Success if the report ran, Running if the report is being run, or Error if the report run failed. The instance of a report run can return an error if, for example, your permission to access the report has been removed since you requested the run. |
| `url`            | String            | URL where results of the report run for that instance are stored. The value is null if the report couldn’t be run because of an error.                                                                                                                                                                                       |
| `ownerId`        | String            | API name of the user that created the instance.                                                                                                                                                                                                                                                                              |
| `hasDetailRows`  | Boolean           | When `false`, indicates that summary level data was requested for the report run. When `true`, indicates that detailed data, which includes summary level data, was requested for the report run.                                                                                                                            |
| `completionDate` | Date, time string | Date, time when the instance of the report run finished. Only available if the report instance ran successfully or couldn’t be run because of an error. Date-time information is in ISO-8601 format.                                                                                                                         |
| `requestDate`    | Date, time string | Date and time when an instance of the report run was requested. Date-time information is in ISO-8601 format.                                                                                                                                                                                                                 |

**See Also**

- [Execute Async](/docs/analytics/salesforce-analytics-rest-api/guide/sforce-analytics-rest-api-instances-summaryasync.md)
- [Instance Results](/docs/analytics/salesforce-analytics-rest-api/guide/sforce-analytics-rest-api-instance-resource-results.md)