---
title: "Get List of Attribute Groups and Attributes"
method: GET
path: "/api/v3.4/attribute_groups"
tags: ["Product Attributes"]
---

# Get List of Attribute Groups and Attributes

`GET /api/v3.4/attribute_groups`

## Request

- Base URL: `https://world.openfoodfacts.org`
- URL: `https://world.openfoodfacts.org/api/v3.4/attribute_groups`
- Auth: API key in header `User-Agent`

for an overview see [Explanation on Product Attributes](https://openfoodfacts.github.io/documentation/docs/Product-Opener/api/explain-product-attributes/)"

## Response `200`

OK

- object: A response object to describe if a READ or WRITE request was successful or not, and if there were errors or warnings, and what the impact of those errors or warnings was.
  - `status` 'success' | 'success_with_warnings' | 'success_with_errors' | 'failure': Overall status of the request: whether it failed or succeeded, with or without warnings or errors.
  - `result` object: Overall result of the request (e.g. a product has been created)
    - `id` string: Identifier of a response result entry
    - `name` string: Name of the response result entry in English.
    - `lc_name` string: Name of the response result entry in the language specified in tags_lc, if supplied.
  - `warnings` WarningOrError[]: List of warnings. Warnings are used to alert about something that may be wrong, but is not necessarily wrong (e.g. a nutrient value that is unexpectedly high).
    - `message` object
      - `id` string: Identifier of a response message.
      - `name` string: Name of the response message entry in English.
      - `lc_name` string: Name of the response message entry in the language specified in tags_lc, if supplied.
      - `description` string: Description of the problem specific to the request, in English.
      - `lc_description` string: Description of the problem specific to the request, in the language specified in tags_lc, if supplied.
    - `field` object: Field that triggered the warning or error.
      - `id` string: Name of the field that triggered the warning or error.
      - `value` string: Value of the field that triggered the warning or error.
    - `impact` object
      - `id` string
      - `name` string
      - `lc_name` string
      - `description` string
      - `lc_description` string
  - `errors` WarningOrError[]: List of errors. Errors are used to alert about something that is definitely wrong (e.g. a nutrient value that is impossibly high).
    - `message` object
      - `id` string: Identifier of a response message.
      - `name` string: Name of the response message entry in English.
      - `lc_name` string: Name of the response message entry in the language specified in tags_lc, if supplied.
      - `description` string: Description of the problem specific to the request, in English.
      - `lc_description` string: Description of the problem specific to the request, in the language specified in tags_lc, if supplied.
    - `field` object: Field that triggered the warning or error.
      - `id` string: Name of the field that triggered the warning or error.
      - `value` string: Value of the field that triggered the warning or error.
    - `impact` object
      - `id` string
      - `name` string
      - `lc_name` string
      - `description` string
      - `lc_description` string
  - `attribute_groups` object[]: A list of attribute groups.
    - `id` string: The ID of the attribute group.
    - `name` string: The name of the attribute group.
    - `warning` string: A warning message related to the attribute group (optional).
    - `attributes` object[]: A list of attributes in the group.
      - `id` string: The ID of the attribute.
      - `name` string: The name of the attribute.
      - `icon_url` string: The URL of the icon representing the attribute.
      - `setting_name` string: The name of the setting for the attribute.
      - `setting_note` string: Additional notes about the setting (optional).
      - `panel_id` string: The panel ID associated with the attribute (optional).
      - `description` string: A detailed description of the attribute (optional).
      - `description_short` string: A short description of the attribute (optional).
      - `default` string: The default value for the attribute (optional).
      - `values` string[]: The possible values for the attribute. Some attributes like allergens have only values "not_important" and "mandatory".
      - `parameters` object[]: Additional parameters for the attribute (optional, used for specific attributes like Unwanted ingredients).
        - `id` string: The ID of the parameter.
        - `name` string: The name of the parameter.
        - `tagtype` string: The tag type of the parameter.
        - `type` 'tags': The type of the parameter. "tags" indicates a comma-separated list of canonical tags is expected.

## Changes

- **2026-11-18** (v3) `ab04ff78cb83`: 2 info
  - added `#/components/schemas/response_status` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/response_status.yaml` from the response body `allOf` list for the response status `200`
- **2025-11-05** (v3) `7138bb1b2d36`: 1 info
  - api operation id `get-api-v3-4-attribute-groups` was added
- **2025-09-22** (v3) `61de618a71ce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-api-v3-under-development/changes/api/v3.4/attribute_groups/get.md)

---

[API](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-api-v3-under-development.md) - [All operations](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-api-v3-under-development/llms.txt) - [OpenAPI document](https://skmtc.dev/openfoodfacts/apis/open-food-facts-open-api-v3-under-development/revisions/ab04ff78cb83?raw)
