---
title: "Get a list of metadata objects of a specific category"
method: GET
path: "/gdc/md/{project_id}/objects/query"
tags: ["metadata-objects-management"]
---

# Get a list of metadata objects of a specific category

`GET /gdc/md/{project_id}/objects/query`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/md/{project_id}/objects/query`
- Auth: none declared

Returns a list of metadata objects of specific category (type).

To obtain a list of all supported object categories, make this API call without any parameters specified: `/gdc/md/{project_id}/objects/query`

In the response body, the item keyword contains a list of metadata objects. The returned objects are sorted by internal ID.

If the next keyword is presented, use {`next_page_link`} to get to the next page of the listed objects. Whenever possible, use {`next_page_link`} and do not create a link with the offset yourself.

## Path parameters

- `project_id` string, required

## Query parameters

- `category` 'analyticaldashboard' | 'attributes' | 'columns' | 'dashboardplugins' | 'dataloadingcolumns' | 'datasets' | 'datefilterconfigs' | 'dimensions' | 'domains' | 'elementmaskings' | 'executioncontexts' | 'facts' | 'filtercontexts' | 'filters' | 'folders' | 'kpi' | 'kpialert' | 'metrics' | 'projectdashboards' | 'prompts' | 'reportdefinition' | 'reports' | 'scheduledmails' | 'tabledataloads' | 'tables' | 'themes' | 'userfilters' | 'visualizationclasses' | 'visualizationobjects' | 'visualizationwidgets', required
- `limit` number, required
- `offset` number
- `orderby` 'id' | 'title' | 'updated'
- `author` string
- `title` string
- `mode` 'raw'
- `deprecated` boolean
- `getTotalCount` boolean

## Response `200`

_

- GetObjectsResponse
  - `objects` object, required
    - `paging` PagingWithTotalCount
      - `offset` integer, required
      - `count` integer, required
    - `items` Object1[], required
      - union
        - AnalyticalDashboard1
          - `analyticalDashboard` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object, required
              - …
        - Attribute1
          - `attribute` object, required
            - `meta` MetaResponse
              - …
            - `content` union
              - …
        - AttributeDisplayForm1
          - `attributeDisplayForm` object, required
            - `meta` MetaResponse
              - …
            - `links` object
              - …
            - `content` object
              - …
        - Column1
          - `column` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - DataLoadingColumn1
          - `dataLoadingColumn` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - DataSet1
          - `dataSet` object, required
            - `content` DataSetContent, required
              - …
            - `meta` MetaResponse, required
              - …
            - `links` object
              - …
        - DateFilterConfig1
          - `dateFilterConfig` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - Dimension1
          - `dimension` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - Domain1
          - `domain` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - ElementMasking1
          - `elementMasking` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - EtlFile1
          - `etlFile` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object, required
              - …
        - ExecutionContext
          - `executionContext` object, required
            - `filters` ExecutionFilterWithId[], required
              - …
            - `dashboard` string, uri, required: dashboard URI
            - `user` string, uri: URI of the user's profile
            - `type` 'MdExecutionContextType' | 'MongoExecutionContextType', required
            - `name` string: name of the saved execution context
        - Fact1
          - `fact` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object: required on input
              - …
        - Filter1
          - `filter` object, required
            - `content` FilterContent, required
              - …
            - `meta` MetaResponse, required
              - …
        - FilterContext1
          - `filterContext` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - Folder1
          - `folder` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object, required
              - …
        - Kpi1
          - `kpi` object, required
            - `content` union, required
              - …
            - `meta` MetaResponse, required
              - …
        - KpiAlert1
          - `kpiAlert` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object, required
              - …
        - Metric1
          - `metric` object, required
            - `content` object, required
              - …
            - `links` object
              - …
            - `meta` MetaResponse, required
              - …
        - ProjectDashboard1
          - `projectDashboard` object, required
            - `meta` MetaResponse
              - …
            - `content` object
              - …
        - Prompt1
          - `prompt` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - Report1
          - `report` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - ReportDefinition1
          - `reportDefinition` object, required
            - `content` object, required
              - …
            - `links` ReportDefinitionLinks
              - …
            - `meta` MetaResponse, required
              - …
        - ScheduledMail1
          - `scheduledMail` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object, required
              - …
        - Table1
          - `table` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - Theme1
          - `theme` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object, required
              - …
        - TableDataLoad1
          - `tableDataLoad` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object, required
              - …
        - UserFilter1
          - `userFilter` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - VisualizationClass1
          - `visualizationClass` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
        - VisualizationObject1
          - `visualizationObject` object, required
            - `meta` MetaResponse, required
              - …
            - `content` object, required
              - …
        - VisualizationWidget1
          - `visualizationWidget` object, required
            - `content` object, required
              - …
            - `meta` MetaResponse, required
              - …
    - `forbidden` string[]

---

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