---
title: "Retrieve a list of MetadataPurposeRegulationOverrides."
method: GET
path: "/metadata/purposes-regulations-overrides"
tags: ["metadata-purpose-regulation-override"]
---

# Retrieve a list of MetadataPurposeRegulationOverrides.

`GET /metadata/purposes-regulations-overrides`

## Request

- Base URL: `https://api.didomi.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.didomi.io/metadata/purposes-regulations-overrides`
- Auth: HTTP bearer

Returns a list of all MetadataPurposeRegulationOverrides. When `override_regulations` is true, a null value of `regulations_id` means all regulations are supported, and an empty array means no regulations are supported. When `override_regulations` is false, catalog regulations stay in effect.

## Query parameters

- `organization_id` string
- `$limit` number
- `$skip` number

## Response `200`

A list of MetadataPurposeRegulationOverride objects

- object: A paginated list of MetadataPurposeRegulationOverride objects
  - `total` number: The total amount of MetadataPurposeRegulationOverrides
  - `limit` number: The limit of MetadataPurposeRegulationOverrides on this query
  - `skip` number: Number of MetadataPurposeRegulationOverrides skipped
  - `data` MetadataPurposeRegulationOverride[]
    - `id` string, required: The unique identifier of the override
    - `organization_id` string, required: ID of the organization that owns the override
    - `created_at` string, date-time: Creation date of the override
    - `updated_at` string, date-time: Last update date of the override
    - `deleted_at` string, date-time: Deletion date of the override
    - `regulations_id` string[]: An array of regulation IDs the override configures the metadata purpose to support when `override_regulations` is true
    - `override_regulations` boolean: When false, catalog regulations stay in effect and `regulations_id` is unused. True (the default for existing rows) applies `regulations_id`, where null means every regulation.
    - `metadata_purpose_id` string, required: The ID of the associated global (organization_id=null) metadata purpose
    - `opted_out_by_gpc` boolean, nullable: Org-scoped GPC flag. Null inherits the catalog purpose default.
    - `necessary_to_generate_revenue` boolean, nullable: Org-scoped Consent-or-Pay flag. Null inherits the catalog purpose default.

## Changes

- **2026-10-01** `32787b3e7b03`: 3 info
  - added the optional property `data/items/necessary_to_generate_revenue` to the response with the `200` status
  - added the optional property `data/items/opted_out_by_gpc` to the response with the `200` status
  - added the optional property `data/items/override_regulations` to the response with the `200` status

[Operation history](https://skmtc.dev/didomi/apis/didomi-api/changes/metadata/purposes-regulations-overrides/get.md)

---

[API](https://skmtc.dev/didomi/apis/didomi-api.md) - [All operations](https://skmtc.dev/didomi/apis/didomi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/didomi/apis/didomi-api/revisions/ce7b9e26bc20?raw)