---
title: "Get a list of values for an attribute label"
method: GET
path: "/gdc/md/{project_id}/obj/{label_id}/elements"
tags: ["attribute-elements"]
---

# Get a list of values for an attribute label

`GET /gdc/md/{project_id}/obj/{label_id}/elements`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/md/{project_id}/obj/{label_id}/elements`
- Auth: none declared

Use this call to get a list of all values belonging to a specific attribute label.

An attribute can have different labels. That is, the attribute values can be displayed differently based on your preferences.

For example, you have the `Day of Week` attribute. When you choose a label for this attribute, you define how you want the attribute values (the week days) to be displayed:

* with their full names: `Sunday`, `Monday`, `Tuesday`, `Wednesday`, `Thursday`, `Friday`, and `Saturday`

* with their shortened names: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri`, and `Sat`

* as numbers from 1 to 7, where 1 is Sunday, 2 is Monday, and so on

In this example, for the label of full names, this call would return the values from `Sunday` to `Saturday`.

For more information about attribute labels and values, see [Determine the Attribute Value ID](https://help.gooddata.com/display/doc/Determine+the+Attribute+Value+ID).

## Path parameters

- `project_id` string, required
- `label_id` string, required

## Query parameters

- `order` 'asc' | 'desc'
- `orderKey` 'label' | 'pk'
- `offset` number
- `limit` number

## Response `200`

_

- AttributeElements
  - `attributeElements` object, required
    - `elements` object[], required
      - `title` unknown, required
      - `uri` string, uri, required
    - `elementsMeta` object, required
      - `attribute` string, uri, required: attribute URI
      - `attributeDisplayForm` string, uri, required: attributeDisplayForm URI
      - `count` integer, required: amount of returned elements
      - `order` 'asc' | 'desc', required
      - `filter` string, required: searched string
      - `mode` 'includeuris', required: results mode
      - `prompt` string, required: uri or an empty string; result is limited to user prompt answer
      - `records` string, int, required: total amount of existing elements for a given attributeDisplayForm
      - `offset` string, int, required: offset of first item, starts from 0
    - `paging` PagingWithTotal, required
      - `offset` integer, required: offset of first item, starts from 0
      - `count` integer, required: amount of returned elements
      - `total` integer, required: total amount of existing elements for a given attributeDisplayForm
      - `next` string, uri, nullable, required: URI of next page

---

[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)