---
title: "Manage Reports via the API"
slug: "manage-reports-via-the-api"
updated: 2026-07-14T16:00:33Z
published: 2026-07-14T16:00:33Z
canonical: "support.dise.com/manage-reports-via-the-api"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.dise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Reports via the API

Reports can be created, accessed and exported via the API to fully automate the reporting process:

1. Create a report
2. Check the report status for successful generation
3. Export the report in JSON format

## Create report

```graphql
mutation CreateReport(
  $name: NonEmptyString!
  $type: ReportType!
  $displayId: [DisplayUID]
  $playlistId: [PlaylistUID]
  $contentName: [NonEmptyString]
  $dateRange: DateRange
) {
  report {
    create(
      name: $name
      type: $type
      displayId: $displayId
      playlistId: $playlistId
      contentName: $contentName
      dateRange: $dateRange
    ) {
      id
      name
      type
      state
      dateRange
      createdAt
    }
  }
}
```

## Get report status

```graphql
query GetReports {
  reports {
    id
    name
    type
    state
    dateRange
    createdAt
  }
}
```

## Export as JSON

```graphql
query GetReport($id: ReportUID!) {
  report(id: $id) {
    id
    name
    type
    state
    export {
      json
    }
  }
}
```

This will return a JSON endpoint URL that contains the reports raw data.