[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [UN sanctions publication status](https://spiral.ai/integrations/codex/un-sanctions-publication-status)

# How to Use UN sanctions publication status in Codex

Returns publication metadata, including generation time, record hashes, and counts by sanctions regime. Use it to compare the available publication with your saved copy before collecting records.

|  |  |
| --- | --- |
| Model | UN sanctions publication status |
| 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 publication status in Codex

- Use UN sanctions publication status for the English edition and add its publication metadata to this project's import report.
- Use UN sanctions publication status to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from UN sanctions publication status and tell me what changed since last week.
- Check UN sanctions publication status and summarize what you find in three bullet points.
- Pull the newest data from UN sanctions publication status and give me the result as a table.

## How to set up UN sanctions publication status in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 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 publication status**: 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/source_status",
    "input": {
      "lang": "en"
    }
  }'
```

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

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

## UN sanctions publication status tools and prices

- [UN Security Council Consolidated Sanctions List · Source status](https://spiral.ai/tools/alexandria/scsanctions-un-org/sanctions/source_status) (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. |

## What can you do with UN sanctions publication status in Codex?

Build a supplier review feature that shows UN-listed business names and the evidence behind candidate matches. Use UN records and publication metadata to make the results inspectable in your application.

### 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.

## Overview

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

## UN sanctions publication status in other agents

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

## More Codex guides

- [UN sanctions name search](https://spiral.ai/integrations/codex/un-sanctions-name-search)
- [UN sanctions record](https://spiral.ai/integrations/codex/un-sanctions-record)
- [UN sanctions list](https://spiral.ai/integrations/codex/un-sanctions-list)
- [UNGM contract award details](https://spiral.ai/integrations/codex/ungm-contract-award-details)
- [UK sanctions name search](https://spiral.ai/integrations/codex/uk-sanctions-name-search)
- [UNGM contract award search](https://spiral.ai/integrations/codex/ungm-contract-award-search)

## Questions about UN sanctions publication status in Codex

**Can Codex use UN sanctions publication status?**

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

**How much does UN sanctions publication status cost in Codex?**

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

**Do I need an Alexandria account to use UN sanctions publication status in Codex?**

No. Spiral runs UN sanctions publication status 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 publication status in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while UN sanctions publication status runs?**

UN sanctions publication status runs in the background. Codex 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.

