---
title: "Get list of attributes"
method: GET
path: "/api/rest/v1/attributes"
tags: ["Attribute"]
---

# Get list of attributes

`GET /api/rest/v1/attributes`

This endpoint allows you to get a list of attributes. Attributes are paginated and sorted by code.

## Query parameters

- `search` string
- `page` integer
- `limit` integer
- `with_count` boolean
- `with_table_select_options` boolean

## Response `200`

Return attributes paginated

- object
  - `_links` object
    - `self` object
      - `href` string — URI of the current page of resources
    - `first` object
      - `href` string — URI of the first page of resources
    - `previous` object
      - `href` string — URI of the previous page of resources
    - `next` object
      - `href` string — URI of the next page of resources
  - `current_page` integer — Current page number
  - `_embedded` object
    - `items` object[]
      - `_links` object
        - `self` object
          - `href` string — URI of the resource
      - `code` string, required — Attribute code
      - `type` 'pim_catalog_identifier' | 'pim_catalog_metric' | 'pim_catalog_number' | 'pim_catalog_reference_data_multi_select' | 'pim_catalog_reference_data_simple_select' | 'pim_catalog_simpleselect' | 'pim_catalog_multiselect' | 'pim_catalog_date' | 'pim_catalog_textarea' | 'pim_catalog_text' | 'pim_catalog_file' | 'pim_catalog_image' | 'pim_catalog_price_collection' | 'pim_catalog_boolean' | 'akeneo_reference_entity' | 'akeneo_reference_entity_collection' | 'pim_catalog_asset_collection' | 'pim_catalog_product_link', required — Attribute type. See <a href='/concepts/catalog-structure.html#attribute'>type</a> section for more details.
      - `labels` object — Attribute labels for each locale
        - `localeCode` string — Attribute label for the locale `localeCode`
      - `group` string, required — Attribute group
      - `group_labels` object — Group labels for each locale
        - `localeCode` string — Group label for the locale `localeCode`
      - `sort_order` integer — Order of the attribute in its group
      - `localizable` boolean — Whether the attribute is localizable, i.e. can have one value by locale
      - `scopable` boolean — Whether the attribute is scopable, i.e. can have one value by channel
      - `available_locales` string[] — To make the attribute locale specfic, specify here for which locales it is specific
      - `unique` boolean — Whether two values for the attribute cannot be the same
      - `useable_as_grid_filter` boolean — Whether the attribute can be used as a filter for the product grid in the PIM user interface
      - `max_characters` integer — Number maximum of characters allowed for the value of the attribute when the attribute type is `pim_catalog_text`, `pim_catalog_textarea` or `pim_catalog_identifier`
      - `validation_rule` string — Validation rule type used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`
      - `validation_regexp` string — Regexp expression used to validate any attribute value when the attribute type is `pim_catalog_text` or `pim_catalog_identifier`
      - `wysiwyg_enabled` boolean — Whether the WYSIWYG interface is shown when the attribute type is `pim_catalog_textarea`
      - `number_min` string — Minimum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`
      - `number_max` string — Maximum integer value allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`
      - `decimals_allowed` boolean — Whether decimals are allowed when the attribute type is `pim_catalog_metric`, `pim_catalog_price` or `pim_catalog_number`
      - `negative_allowed` boolean — Whether negative values are allowed when the attribute type is `pim_catalog_metric` or `pim_catalog_number`
      - `metric_family` string — Metric family when the attribute type is `pim_catalog_metric`
      - `default_metric_unit` string — Default metric unit when the attribute type is `pim_catalog_metric`
      - `date_min` string, date-time — Minimum date allowed when the attribute type is `pim_catalog_date`
      - `date_max` string, date-time — Maximum date allowed when the attribute type is `pim_catalog_date`
      - `allowed_extensions` string[] — Extensions allowed when the attribute type is `pim_catalog_file` or `pim_catalog_image`
      - `max_file_size` string — Max file size in MB when the attribute type is `pim_catalog_file` or `pim_catalog_image`
      - `reference_data_name` string — Reference entity code when the attribute type is `akeneo_reference_entity` or `akeneo_reference_entity_collection` OR Asset family code when the attribute type is `pim_catalog_asset_collection`
      - `default_value` boolean — Default value for a Yes/No attribute, applied when creating a new product or product model (only available since the 5.0)
      - `table_configuration` object[] — Configuration of the Table attribute (columns)
        - `code` string, required — Column code
        - `data_type` 'select' | 'text' | 'number' | 'boolean' | 'incremental_number' | 'reference_entity' | 'product_link' | 'measurement' | 'date', required — Column data type
        - `validations` object — User defined validation constraints on the cell content
          - `min` number — minimum value of a numeric cell
          - `max` number — maximum value of a numeric cell
          - `decimals_allowed` boolean — whether the value of a numeric cell can hold a decimal part
          - `max_length` number — maximum length of a text cell
        - `labels` object — Column labels for each locale
          - `localeCode` string — Column label for the locale `localeCode`
        - `is_required_for_completeness` boolean — Defines if the column should be entirely filled for the attribute to be considered complete
      - `is_main_identifier` boolean — Is this attribute main identifier when attribute type is `pim_catalog_identifier`
      - `is_mandatory` boolean — This attribute must be enriched from the moment a product is created. It will be mandatory across all families.
      - `decimal_places_strategy` string — Defines the decimal places strategy. Available options are `round`, `forbid` and `trim`.
      - `decimal_places` number — Defines the number of decimal places when decimal places strategy is `round` or `forbid`.

## Other responses

- `401` — Authentication required
- `403` — Access forbidden
- `406` — Not Acceptable

---

[API](https://skmtc.net/akeneo/apis/akeneo-pim-rest-api.md) · [All operations](https://skmtc.net/akeneo/apis/akeneo-pim-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akeneo/akeneo-pim-rest-api/versions/d8bda9b93b59/schema)