---
title: "Sanctions list change feed"
method: GET
path: "/sanctions/changes"
tags: ["Sanctions"]
---

# Sanctions list change feed

`GET /sanctions/changes`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/sanctions/changes`
- Auth: HTTP bearer

Additions, removals and amendments detected on each refresh. A `change_type` of `bulk` is a single row per list summarising a held-back mass change (no entity, never a watchlist hit); see the `change_type` parameter.

## Query parameters

- `since` string, date
- `change_type` 'listed' | 'delisted' | 'relisted' | 'renamed' | 'bulk'
- `list` string
- `limit` integer

## Response `200`

OK

- object
  - `data` SanctionsChange[]
    - `id` integer
    - `change_type` 'listed' | 'delisted' | 'relisted' | 'renamed' | 'bulk': `bulk` is one row per list for a source-side mass change held for review: no entity (`entity_id`, `entity_type`, `country` null), never a watchlist hit.
    - `entity_id` integer, nullable
    - `source_list` string: Source list code, e.g. EU, OFAC.
    - `source_id` string, nullable
    - `entity_name` string, nullable
    - `entity_type` 'person' | 'company' | 'vessel' | 'aircraft' | 'unknown', nullable: Null on a `bulk` row.
    - `country` string, nullable
    - `program` string, nullable
    - `details` object, nullable
    - `detected_at` string, date-time
  - `meta` object
    - `since` string
    - `result_count` integer
    - `rate_limit` RateLimitMeta
      - `rpm_remaining` integer
      - `daily_remaining` integer

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key
- `403`: Key lacks the required scope or country access
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api.md) · [All operations](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/revisions/fb8b4de5b18d?raw)