---
title: "Get all Reports"
method: GET
path: "/api/v1/entities/workspaces/{workspaceId}/reports"
tags: ["Reports"]
---

# Get all Reports

`GET /api/v1/entities/workspaces/{workspaceId}/reports`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/entities/workspaces/{workspaceId}/reports`
- Auth: none declared

## Path parameters

- `workspaceId` string, required

## Query parameters

- `origin` 'ALL' | 'PARENTS' | 'NATIVE': Defines scope of origin of objects. All by default.
- `filter` string
- `include` string[]
- `page` integer
- `size` integer
- `sort` string[]
- `metaInclude` string[]: Included meta objects

## Headers

- `X-GDC-VALIDATE-RELATIONS` boolean

## Response `200`

Request successfully processed

- JsonApiReportOutList: A JSON:API document with a list of resources
  - `data` JsonApiReportOutWithLinks[], required
    - `attributes` object, required
      - `areRelationsValid` boolean
      - `content` object, required: Free-form report definition, stored verbatim - not parsed, validated or migrated. Maximum supported length is 250000 characters.
      - `createdAt` string, date-time, nullable: Time of the entity creation.
      - `description` string
      - `modifiedAt` string, date-time, nullable: Time of the last entity modification.
      - `periodEnd` string, date, required: Last day of the reported period, inclusive.
      - `periodStart` string, date, required: First day of the reported period, inclusive.
      - `tags` string[]
      - `title` string, required
      - `variableValues` unknown
    - `id` string, required: API identifier of an object
    - `meta` object
      - `origin` object
        - `originId` string, required: defines id of the workspace where the entity comes from
        - `originType` 'NATIVE' | 'PARENT', required: defines type of the origin of the entity
    - `relationships` object
      - `createdBy` object
        - `data` JsonApiUserIdentifierToOneLinkage, required: The \"type\" and \"id\" to non-empty members.
          - `id` string, required
          - `type` 'userIdentifier', required
      - `modifiedBy` object
        - `data` JsonApiUserIdentifierToOneLinkage, required: The \"type\" and \"id\" to non-empty members.
          - `id` string, required
          - `type` 'userIdentifier', required
    - `type` 'report', required: Object type
    - `links` ObjectLinks
      - `self` string, uri, required: A string containing the link's URL.
  - `included` JsonApiUserIdentifierOutWithLinks[]: Included resources
    - `attributes` object
      - `email` string
      - `firstname` string
      - `lastname` string
    - `id` string, required: API identifier of an object
    - `type` 'userIdentifier', required: Object type
    - `links` ObjectLinks
      - `self` string, uri, required: A string containing the link's URL.
  - `links` ListLinks
    - `self` string, uri, required: A string containing the link's URL.
    - `next` string, uri: A string containing the link's URL for the next page of data.
  - `meta` object
    - `page` PageMetadata
      - `number` integer: The number of the current page
      - `size` integer: The size of the current page
      - `totalElements` integer: The total number of elements
      - `totalPages` integer: The total number of pages
    - `restricted` RestrictedObject[]: References withheld from `included` because the caller may not view them. Their `relationships` entries are kept, so a client can render a placeholder instead of treating the reference as missing. Empty when the caller may view every reference in the payload; absent entirely when no object-level permissions apply to the request.
      - `id` string, required: Object identifier, unique within one workspace hierarchy.
      - `type` 'analyticalDashboard' | 'attribute' | 'attributeHierarchy' | 'computedAttribute' | 'fact' | 'label' | 'metric' | 'userDataFilter' | 'visualizationObject', required: JSON:API type of the restricted object. Matches the `type` of its entry in the resource's `relationships`.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)