---
title: "Retrieve a list of purposes groups"
method: GET
path: "/metadata/purposes-groups"
tags: ["purposes-groups"]
---

# Retrieve a list of purposes groups

`GET /metadata/purposes-groups`

Returns a list of all purposes groups

## Query parameters

- `$limit` integer
- `$skip` integer
- `$sort` object
- `filter` PurposesGroups — A group of purposes
  - `id` string — Group ID
  - `name` string, required — Name of the group
  - `description` string — Description of the group
  - `namespaces` object — IDs of this group in other namespaces / vendor lists and used in Didomi SDKs and consents
    - `iab2` string — ID of the group in the IAB TCF version 2 as a stack ID
  - `purposes_id` string[] — Purposes that belong to the group
  - `organization_id` string — ID of the organization that owns the group. If ID is null, the group is global.
  - `created_at` string, date-time — Creation date of the purpose
  - `updated_at` string, date-time — Last update date of the purpose

## Response `200`

A list of PurposesGroup objects

- PurposesGroups[]
  - `id` string — Group ID
  - `name` string, required — Name of the group
  - `description` string — Description of the group
  - `namespaces` object — IDs of this group in other namespaces / vendor lists and used in Didomi SDKs and consents
    - `iab2` string — ID of the group in the IAB TCF version 2 as a stack ID
  - `purposes_id` string[] — Purposes that belong to the group
  - `organization_id` string — ID of the organization that owns the group. If ID is null, the group is global.
  - `created_at` string, date-time — Creation date of the purpose
  - `updated_at` string, date-time — Last update date of the purpose

---

[API](https://skmtc.net/didomi/apis/didomi-api.md) · [All operations](https://skmtc.net/didomi/apis/didomi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/didomi/didomi-api/revisions/c82339816c36/schema)