---
title: "Get Attribute Groups"
method: GET
path: "/api/v2/attribute_groups"
tags: ["Personal Search"]
---

# Get Attribute Groups

`GET /api/v2/attribute_groups`

## Request

- Base URL: `https://world.openfoodfacts.net`
- URL: `https://world.openfoodfacts.net/api/v2/attribute_groups`
- Auth: API key in header `User-Agent`

Attributes are at the heart of personal search.
They score the products according to different criterias,
which could then be matched to a user's preferences.

This API helps you list attributes and display them in your application,
for the user to choose the importance of each criteria.

note: `/api/v2/attribute_groups_{lc}` is also a valid route, but consider it deprecated

## Query parameters

- `lc` string

## Response `200`

OK

- object[]: List of groups of attributes for personal search in a specific language.
  - `id` string: unique id of the group
  - `name` string: Name of the group
  - `attributes` object[]: Attributes that are part of this group
    - `id` string: unique id of the attribute
    - `name` string: Name of the attribute
    - `icon_url` string: url of icon to display next to the settings for this attribute
    - `setting_name` string: a description of the attribute to display to users
    - `setting_note` string: a complementary note on the attribute
    - `default` 'mandatory' | 'very_important' | 'important' | 'not_important': Indicates the default setting for this attribute
    - `panel_id` string: Linked knowledge panel (optional)

## Changes

- **2026-11-18** `ebaef6823f1f`: 1 breaking, 1 info
  - the response's body type changed from no type to `array` for status `200`
  - added the new optional `query` request parameter `lc`
- **2025-11-07** `61843b2fdbde`: 1 warning
  - deleted the `query` request parameter `lc`
- **2025-07-02** `7193ad484e5d`: 2 info
  - api tag `Personal Search` added
  - api tag `Personal search` removed

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

---

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