# United Nations API: Check sanctions > Checks a person or organisation name against the current UN Security Council Consolidated List and returns ranked possible matches. Unofficial. Not affiliated with or endorsed by United Nations. - Page: https://fous.com/methods/scsanctions.un.org/check-sanctions - Method: `scsanctions.un.org/check_sanctions`, version 1 - Website: scsanctions.un.org - Returns: match flag, summary, list date, matches with name, type, reference, regime, aliases, nationality, birth data, addresses, reason - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `name` | string | yes | `"Al-Shabaab"` | Person or organisation name to check, for example Al-Shabaab. | | `type` | string | no | | Kind of listing, for example entity; defaults to any. One of "any", "individual", "entity". Default "any". | | `max_results` | integer | no | | Maximum number of matches to return, for example 20 (up to 100). Default 20. | | `nationality` | string | no | | Optionally restrict individuals to this listed country of nationality, for example Somalia; entries without a listed nationality are excluded. Default "". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "name": "Al-Shabaab" } ``` Its output: ```json { "matches": [ { "name": "AL-SHABAAB", "type": "entity", "aliases": [ "AL-SHABAB", "SHABAAB", "THE YOUTH" ], "addresses": [], "entry_link": "https://scsanctions.un.org/r#:~:text=SOe.001", "listed_date": "2010-04-12", "nationality": null, "date_of_birth": null, "place_of_birth": null, "reason_summary": null, "sanctions_regime": "Al-Shabaab (Somalia)", "un_reference_number": "SOe.001" } ], "summary": "1 possible match found on the UN Security Council Consolidated List dated 2026-10-22.", "match_found": true, "list_generation_date": "2026-10-22" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"scsanctions.un.org/check_sanctions","input":{"name":"Al-Shabaab"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Is there a UN Security Council sanctions listing for Hezbollah Financial Network? Check it and show me any ranked matches with regime and reason. - Screen the name Viktor Bout against the UN consolidated sanctions list, individuals only, and list aliases and birth details. - Check whether the entity Al-Qaida in the Islamic Maghreb appears on the UN sanctions list and return up to 10 matches. - Run a UN sanctions check on individuals named Mohammed Al-Hassan with Somalia as the listed nationality, limiting results to 5. - On un.org, look up any UN Security Council listing for the organisation Harakat al-Shabaab Mujahideen and tell me the list date and addresses. ## Input schema ```json { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "minLength": 2, "description": "Person or organisation name to check, for example Al-Shabaab." }, "type": { "enum": [ "any", "individual", "entity" ], "type": "string", "default": "any", "description": "Kind of listing, for example entity; defaults to any." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of matches to return, for example 20 (up to 100)." }, "nationality": { "type": "string", "default": "", "description": "Optionally restrict individuals to this listed country of nationality, for example Somalia; entries without a listed nationality are excluded." } } } ``` ## Output schema ```json { "type": "object", "required": [ "match_found", "summary", "list_generation_date", "matches" ], "properties": { "matches": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "enum": [ "individual", "entity" ], "type": "string" }, "aliases": { "type": "array", "items": { "type": "string" } }, "addresses": { "type": "array", "items": { "type": "string" } }, "entry_link": { "type": "string" }, "listed_date": { "type": [ "string", "null" ] }, "nationality": { "type": [ "string", "null" ] }, "date_of_birth": { "type": [ "string", "null" ] }, "place_of_birth": { "type": [ "string", "null" ] }, "reason_summary": { "type": [ "string", "null" ] }, "sanctions_regime": { "type": "string" }, "un_reference_number": { "type": "string" } } } }, "summary": { "type": "string" }, "match_found": { "type": "boolean" }, "list_generation_date": { "type": "string" } } } ``` ## See more - [GOV.UK API: Check a name against the UK Sanctions List](https://fous.com/methods/gov.uk/check-sanctions.md): Checks a name against the current UK Sanctions List and returns possible matches in the site's best-match order, with designation details. Results may include entries that only mention the name in their reasons, so check each entry before identifying anyone. - [EU Sanctions Map API: Check name against EU sanctions](https://fous.com/methods/sanctionsmap.eu/check-sanctions.md): Checks a person or organisation name against the EU consolidated financial sanctions list (asset freezes) on the EU Sanctions Map, returning likely matches with their regime, aliases, listing details and linked legal act. Name similarity is a screening aid, not identity confirmation. - [Treasury OFAC API: Check sanctions](https://fous.com/methods/sanctionssearch.ofac.treas.gov/check-sanctions.md): Screens a name against the OFAC SDN and non-SDN sanctions lists. Returns scored entries with identifying details. Similar names are potential matches, not confirmed identities. - [EU Sanctions Map API: Get country sanctions](https://fous.com/methods/sanctionsmap.eu/get-country-sanctions.md): Lists EU Sanctions Map regimes concerning a country, with measures, EUR-Lex legal acts, amendment dates and listed person and entity counts. - [ProPublica API: Search nonprofits by name](https://fous.com/methods/projects.propublica.org/search-nonprofits.md): Finds U.S. nonprofits by organization name, optionally filtered by state and city, with the latest reported revenue and assets. - [IRS API: Check charity status](https://fous.com/methods/irs.gov/check-charity-status.md): Looks up an organization in the IRS Tax Exempt Organization Search by name or EIN. It reports whether donations are deductible, whether the organization was automatically revoked, and its recent Form 990 filings. - [NIST API: Search vulnerabilities](https://fous.com/methods/nvd.nist.gov/search-vulnerabilities.md): Finds known vulnerabilities (CVEs) in the NVD that match a product or vendor name, newest first. Each CVE is flagged when it is in CISA's known exploited catalog. - [GOV.UK API: Get travel advice](https://fous.com/methods/gov.uk/get-travel-advice.md): Returns current UK government (FCDO) travel warnings, entry requirements for British passport holders, safety, health and emergency information for a country. Summaries are shortened; follow the link for full details.