---
title: "List partner-purpose associations"
method: GET
path: "/metadata/partners-purposes"
tags: ["metadata"]
---

# List partner-purpose associations

`GET /metadata/partners-purposes`

Returns a paginated list of partner-purpose associations the user has access to

## Query parameters

- `$limit` integer
- `$skip` integer
- `$sort` object
- `filter` PartnersPurposes
  - `id` string, required — Unique identifier for the partner-purpose association
  - `metadata_partner_id` string, required — Foreign key reference to metadata-partners(id)
  - `metadata_purpose_id` string, required — Foreign key reference to metadata-purposes(id)
  - `organization_id` string, nullable — Optional organization ID for org-specific overrides. Null indicates a global association
  - `processing_rules` string[], required — Processing rules for this partner-purpose combination
  - `is_org_override` boolean — Read-only flag indicating if this is an organization override of a global association
  - `default_purposes_id` string, nullable — Legacy foreign key reference to metadata-partners-default-purposes(id)
  - `legitimate_interest_purposes_id` string, nullable — Legacy foreign key reference to metadata-partners-legitimate-interest-purposes(id)
  - `created_at` string, date-time — Timestamp of record creation
  - `updated_at` string, date-time — Timestamp of last update
  - `version` integer — Version number for concurrency control

## Response `200`

- object
  - `total` integer — Total number of records
  - `limit` integer — Number of records per page
  - `skip` integer — Number of records to skip
  - `data` PartnersPurposes[]
    - `id` string, required — Unique identifier for the partner-purpose association
    - `metadata_partner_id` string, required — Foreign key reference to metadata-partners(id)
    - `metadata_purpose_id` string, required — Foreign key reference to metadata-purposes(id)
    - `organization_id` string, nullable — Optional organization ID for org-specific overrides. Null indicates a global association
    - `processing_rules` string[], required — Processing rules for this partner-purpose combination
    - `is_org_override` boolean — Read-only flag indicating if this is an organization override of a global association
    - `default_purposes_id` string, nullable — Legacy foreign key reference to metadata-partners-default-purposes(id)
    - `legitimate_interest_purposes_id` string, nullable — Legacy foreign key reference to metadata-partners-legitimate-interest-purposes(id)
    - `created_at` string, date-time — Timestamp of record creation
    - `updated_at` string, date-time — Timestamp of last update
    - `version` integer — Version number for concurrency control

---

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