Resolve policy

Resolve a single policy by ID. Optionally pin to a specific version — returns null if the version does not match.

GET /api/policies/resolve

Resolve policy

cURL

curl --request GET \
  --url https://agenticadvertising.org/api/policies/resolve

200

{
  "policy_id": "gdpr_consent",
  "version": "1.0.0",
  "name": "GDPR Consent Requirements",
  "description": "Requirements for valid consent under GDPR",
  "jurisdictions": [
    "EU",
    "EEA"
  ],
  "region_aliases": {
    "EU": [
      "DE",
      "FR",
      "IT"
    ]
  },
  "policy_categories": [
    "age_restricted",
    "pharmaceutical_advertising"
  ],
  "channels": [
    "display",
    "video"
  ],
  "governance_domains": [
    "campaign",
    "creative"
  ],
  "effective_date": "2025-05-25T00:00:00.000Z",
  "sunset_date": "<string>",
  "source_url": "https://eur-lex.europa.eu/eli/reg/2016/679/oj",
  "source_name": "EUR-Lex",
  "policy": "Data subjects must provide freely given, specific, informed and unambiguous consent...",
  "guidance": "<string>",
  "exemplars": {
    "pass": [
      {
        "scenario": "Ad for alcohol shown during children's programming",
        "explanation": "Violates watershed timing rules for alcohol advertising"
      }
    ],
    "fail": [
      {
        "scenario": "Ad for alcohol shown during children's programming",
        "explanation": "Violates watershed timing rules for alcohol advertising"
      }
    ]
  },
  "ext": {},
  "created_at": "2026-03-01T12:00:00.000Z",
  "updated_at": "2026-03-01T12:00:00.000Z"
}

Query Parameters

policy_id · string · required

Example:

"gdpr_consent"

version · string

Return null if the current version does not match

Response

200

application/json

Policy resolved

policy_id · string · required

Example:

"gdpr_consent"

version · string · required

Example:

"1.0.0"

name · string · required

Example:

"GDPR Consent Requirements"

description · string | null · required

Example:

"Requirements for valid consent under GDPR"

category · enum<string> · required

Available options: regulation, standard

enforcement · enum<string> · required

Available options: must, should, may

jurisdictions · string[] · required

Example:

["EU", "EEA"]

region_aliases · object · required

Show child attributes

Example:

{ "EU": ["DE", "FR", "IT"] }

policy_categories · string[] · required

Example:

[
  "age_restricted",
  "pharmaceutical_advertising"
]

channels · string[] | null · required

Example:

["display", "video"]

governance_domains · string[] · required

Example:

["campaign", "creative"]

effective_date · string | null · required

Example:

"2025-05-25T00:00:00.000Z"

sunset_date · string | null · required

source_url · string | null · required

Example:

"https://eur-lex.europa.eu/eli/reg/2016/679/oj"

source_name · string | null · required

Example:

"EUR-Lex"

policy · string · required

Example:

"Data subjects must provide freely given, specific, informed and unambiguous consent..."

guidance · string | null · required

exemplars · object · required

Show child attributes

ext · object · required

Show child attributes

source_type · enum<string> · required

Available options: registry, community

review_status · enum<string> · required

Available options: pending, approved

created_at · string · required

Example:

"2026-03-01T12:00:00.000Z"

updated_at · string · required

Example:

"2026-03-01T12:00:00.000Z"