[Integrations](https://spiral.ai/integrations) › [Notion](https://spiral.ai/integrations/notion) › [UN sanctions record](https://spiral.ai/integrations/notion/un-sanctions-record)

# How to Use UN sanctions record in Notion

Returns one UN sanctions entry with names, aliases, addresses, listing dates, and available identifying details. Use it to examine a business match once you have its UN reference number.

|  |  |
| --- | --- |
| Model | UN sanctions record |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with UN sanctions record in Notion

- Each week, use UN sanctions record to retrieve KPe.001 and report changes to its published aliases, addresses, listing dates, or supplementary information.
- Every Monday at 9am: use UN sanctions record to look this up and give me the result as a table.
- Pull the latest numbers from UN sanctions record and tell me what changed since last week.
- Check UN sanctions record and summarize what you find in three bullet points.
- Pull the newest data from UN sanctions record and give me the result as a table.

## How to set up UN sanctions record in Notion

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Notion this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Allow custom MCP servers**: A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

2. **Add Spiral to a custom agent**: Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

4. **Run UN sanctions record in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds UN sanctions record, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run UN sanctions record**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "scsanctions-un-org/sanctions/records_get",
    "input": {
      "lang": "en"
    }
  }'
```

Then paste one of the prompts above: Notion finds UN sanctions record on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/notion

## UN sanctions record tools and prices

- [UN Security Council Consolidated Sanctions List · Records get](https://spiral.ai/tools/alexandria/scsanctions-un-org/sanctions/records_get) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| lang | en, fr, ar, ru, sp, ch | en | Language edition of the list: en (default), fr, ar, ru, sp (Spanish), ch (Chinese). The router's own codes; es and zh are not accepted upstream. Reference numbers and DATAIDs are the same in every edition, the publication id is not. |
| dataid |  | — | Numeric DATAID, e.g. 113219. Pattern: ^[0-9]+$. |
| reference_number |  | — | Permanent reference number, e.g. QDi.001 (prefix = regime, i = individual, e = entity). |

## What can you do with UN sanctions record in Notion?

Keep a recurring UN sanctions review focused on changes that affect business counterparties. Compare saved publications and organization records, then report candidate matches and changed identifying details.

### Supplier onboarding review

Check the available publication, collect the relevant UN records, search a prospective supplier's business name, and inspect candidate entries. Produce a review table showing names, aliases, addresses, and UN references.

### Shipping counterparty review

Compare freight counterparties with UN-listed organizations. Use publication metadata and a collected snapshot to document the source, then search company names and examine the identifying details behind candidate matches.

### Recurring business rescreening

Compare the available UN publication with the previous collection, refresh the organization records, and rerun business-name checks. Fetch candidate records to explain which aliases, addresses, or listing details need review.

### Screening software validation

Use public listed organizations such as Korea Mining Development Trading Corporation as test cases. Compare name-search candidates with full records and the collected list, while retaining publication metadata with the test results.

### Sanctions regime briefing

Collect organization records for a UN sanctions regime and summarize the published names, aliases, addresses, and listing dates. Use publication status to identify the edition behind the briefing and individual records for detailed examples.

### Business alias investigation

Search a company's trading name and inspect candidate records for aliases, former names, and addresses. Prepare an evidence table that makes similarities and differences visible to the reviewer.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Notion guides](https://spiral.ai/integrations/notion)

## UN sanctions record in other agents

- [Amp](https://spiral.ai/integrations/amp/un-sanctions-record)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/un-sanctions-record)
- [Claude](https://spiral.ai/integrations/claude-desktop/un-sanctions-record)
- [Claude Code](https://spiral.ai/integrations/claude-code/un-sanctions-record)
- [Cline](https://spiral.ai/integrations/cline/un-sanctions-record)
- [Codex](https://spiral.ai/integrations/codex/un-sanctions-record)
- [Cursor](https://spiral.ai/integrations/cursor/un-sanctions-record)
- [Devin](https://spiral.ai/integrations/devin/un-sanctions-record)
- [dots](https://spiral.ai/integrations/dots/un-sanctions-record)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/un-sanctions-record)
- [Gemini](https://spiral.ai/integrations/gemini/un-sanctions-record)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/un-sanctions-record)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/un-sanctions-record)
- [goose](https://spiral.ai/integrations/goose/un-sanctions-record)
- [Grok](https://spiral.ai/integrations/grok/un-sanctions-record)
- [Grok Build](https://spiral.ai/integrations/grok-build/un-sanctions-record)
- [Hermes](https://spiral.ai/integrations/hermes/un-sanctions-record)
- [Instinct](https://spiral.ai/integrations/instinct/un-sanctions-record)
- [Manus](https://spiral.ai/integrations/manus/un-sanctions-record)
- [Muse](https://spiral.ai/integrations/muse/un-sanctions-record)
- [Muse Code](https://spiral.ai/integrations/muse-code/un-sanctions-record)
- [n8n](https://spiral.ai/integrations/n8n/un-sanctions-record)
- [OpenClaw](https://spiral.ai/integrations/openclaw/un-sanctions-record)
- [opencode](https://spiral.ai/integrations/opencode/un-sanctions-record)
- [Perplexity](https://spiral.ai/integrations/perplexity/un-sanctions-record)
- [Raycast](https://spiral.ai/integrations/raycast/un-sanctions-record)
- [VS Code](https://spiral.ai/integrations/vscode/un-sanctions-record)
- [Windsurf](https://spiral.ai/integrations/windsurf/un-sanctions-record)
- [Zapier](https://spiral.ai/integrations/zapier/un-sanctions-record)

## More Notion guides

- [UN sanctions publication status](https://spiral.ai/integrations/notion/un-sanctions-publication-status)
- [UNGM contract award details](https://spiral.ai/integrations/notion/ungm-contract-award-details)
- [UN sanctions name search](https://spiral.ai/integrations/notion/un-sanctions-name-search)
- [UNGM contract award search](https://spiral.ai/integrations/notion/ungm-contract-award-search)
- [UN sanctions list](https://spiral.ai/integrations/notion/un-sanctions-list)
- [UNGM procurement category search](https://spiral.ai/integrations/notion/ungm-procurement-category-search)

## Questions about UN sanctions record in Notion

**Can Notion use UN sanctions record?**

Yes. Add Spiral to Notion as an MCP server, and Notion can find and run UN sanctions record like any built-in tool.

**How much does UN sanctions record cost in Notion?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Notion plan is separate.

**Do I need an Alexandria account to use UN sanctions record in Notion?**

No. Spiral runs UN sanctions record on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up UN sanctions record in Notion?**

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

**Does Notion wait while UN sanctions record runs?**

UN sanctions record runs in the background. Notion starts the run, checks on it and gives you the json when it's ready.

**Which sanctions does this source cover?**

It covers individuals and entities subject to UN Security Council sanctions measures. Its coverage boundary is Security Council designations, so a search here does not answer whether a business appears on a separate national sanctions list.

**When does the UN update the data?**

Changes follow sanctions committee decisions. For the ISIL and Al-Qaida list, the UN says changes take effect on the list immediately after the relevant decision, and the consolidated list is updated following those changes.

**Does every entry have complete identifying information?**

No. The UN explicitly uses "na" when the responsible committee has not obtained a detail, so the published list can contain incomplete identifying information.

**Is an alias match enough to identify a listed party?**

An informal alias alone can be insufficient. The UN's listing form specifically says nicknames and other informal pseudonyms generally do not establish a positive identification by themselves.

**Where can I check what changed?**

The UN maintains a separate public change log. It records the change date, sanctions list, permanent reference numbers, update type, affected-entry count, and links to notifications.

