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

# How to Use UN sanctions record in Gemini

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 Gemini

- Use UN sanctions record to retrieve KPe.001 and summarize the published business names, addresses, listing date, and supplementary information.
- 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 Gemini

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

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

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

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini 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 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: Gemini finds UN sanctions record on Spiral, shows the price and runs it.

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

## 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 Gemini?

Prepare a readable business screening brief from the UN's published sanctions information. Explain candidate matches using company names, aliases, addresses, and the publication available for review.

### 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 Gemini guides](https://spiral.ai/integrations/gemini)

## 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 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)
- [Notion](https://spiral.ai/integrations/notion/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 Gemini guides

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

## Questions about UN sanctions record in Gemini

**Can Gemini use UN sanctions record?**

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

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

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

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

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 Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

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

UN sanctions record runs in the background. Gemini 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.

