--- type: "firecrawl-provider" description: "The United Nations Security Council Consolidated List (scsanctions.un.org): every individual and entity subject to Security Council sanctions measures, published as one XML file per language edition and regenerated nightly. Publication status (dateGenerated, Content-MD5, Last-Modified, canonical record hash, counts per regime), the full record list paginated with a cursor pinned to one publication, one record by permanent reference number or DATAID, and an in-memory name search. Measures and legal basis are derived from a regime table and marked as such; the file carries no delta feed, so there is no records_changes function. Anonymous, read-only. The UN declares no open licence for this data (https://www.un.org/en/about-us/terms-of-use); a match or an absence is not a compliance determination." use_when: "The United Nations Security Council Consolidated List (scsanctions.un.org): every individual and entity subject to Security Council sanctions measures, published as one XML file per language edition and regenerated nightly. Publication status (dateGenerated, Content-MD5, Last-Modified, canonical record hash, counts per regime), the full record list paginated with a cursor pinned to one publication, one record by permanent reference number or DATAID, and an in-memory name search. Measures and legal basis are derived from a regime table and marked as such; the file carries no delta feed, so there is no records_changes function. Anonymous, read-only. The UN declares no open licence for this data (https://www.un.org/en/about-us/terms-of-use); a match or an absence is not a compliance determination." categories: "Public records" capabilities: 4 credits_per_call: 5 --- # UN Security Council Consolidated Sanctions List on Firecrawl Alexandria The United Nations Security Council Consolidated List (scsanctions.un.org): every individual and entity subject to Security Council sanctions measures, published as one XML file per language edition and regenerated nightly. Publication status (dateGenerated, Content-MD5, Last-Modified, canonical record hash, counts per regime), the full record list paginated with a cursor pinned to one publication, one record by permanent reference number or DATAID, and an in-memory name search. Measures and legal basis are derived from a regime table and marked as such; the file carries no delta feed, so there is no records_changes function. Anonymous, read-only. The UN declares no open licence for this data (https://www.un.org/en/about-us/terms-of-use); a match or an absence is not a compliance determination. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `scsanctions-un-org` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/scsanctions-un-org) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/openapi.json) ## Capabilities - [Records get](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/sanctions/records_get): One record by the source's own id: `reference_number` (the permanent reference number, QDi.001 / KPe.001 / IRi.043 ..., case-insensitive) or `dataid` (the numeric DATAID), exactly one of them. The file is fetched and the record selected in memory (no per-record page exists upstream); an id not in the current publication is not_found. The answer carries the publication fields so the record can be tied to a snapshot. - [Records list](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/sanctions/records_list): The full current list of one language edition, paginated in file order (INDIVIDUALS then ENTITIES, each by permanent reference number) and optionally filtered by regime (UN_LIST_TYPE or slug) and entity_type. Every page re-fetches the file (the runner keeps no state) and pins its canonical publication_id in the cursor; when the publisher has moved on, the next page fails with invalid_input and issue code `publication_changed` on /continuation instead of mixing publications: restart from the first page. A continuation overrides the filters (passing different ones is `cursor_mismatch`). A regime with no records of the requested type (e.g. GB organizations) is a legitimate empty page with total 0. Each record carries source_record_id (un:), source_url, publication_id and retrieved_at; measures and legal_basis are derived from the regime table (`derived` names them). - [Search](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/sanctions/search): Name search over one language edition, in memory (the site has no search): case-insensitive substring match on the primary name, the original-script name and every alias, plus exact match on the reference number or DATAID; optional regime and entity_type filters. `total` counts every match, `records` holds the first `limit` (default 20, max 100) in file order; a query matching nothing is a successful empty result (total 0). Use `lang: ar` (or fr, ru, sp, ch) to match names in that edition's script. Not a compliance determination. - [Source status](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/sanctions/source_status): Cheap version check of one language edition: GET the consolidated XML through its 302 (the signed Azure blob is followed at call time, never returned) and report the file's dateGenerated (published_at), the blob's Last-Modified, ETag and publisher-posted Content-MD5, the file URL and size, the canonical publication_id (SHA-256 over the records, stable across nightly regenerations that change nothing), record counts (total, individuals, entities) and per-regime counts. `changes_feed` is always false: the UN publishes no deltas. The whole 2.2 MB file is read because record counts and the canonical hash need it. ## 1. Choose this provider when The United Nations Security Council Consolidated List (scsanctions.un.org): every individual and entity subject to Security Council sanctions measures, published as one XML file per language edition and regenerated nightly. Publication status (dateGenerated, Content-MD5, Last-Modified, canonical record hash, counts per regime), the full record list paginated with a cursor pinned to one publication, one record by permanent reference number or DATAID, and an in-memory name search. Measures and legal basis are derived from a regime table and marked as such; the file carries no delta feed, so there is no records_changes function. Anonymous, read-only. The UN declares no open licence for this data (https://www.un.org/en/about-us/terms-of-use); a match or an absence is not a compliance determination. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "scsanctions-un-org", "capability": "sanctions/records_get", "options": { "reference_number": "QDi.001" } } ``` ## 3. Add provider options Use only the options needed for the task: - `dataid` (string): Numeric DATAID, e.g. 113219. Pattern: ^[0-9]+$. Example: `` - `lang` (string): 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. Example: `en` - `reference_number` (string): Permanent reference number, e.g. QDi.001 (prefix = regime, i = individual, e = entity). Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "scsanctions-un-org", capability: "sanctions/records_get", options: { reference_number: "QDi.001", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "scsanctions-un-org", "capability": "sanctions/records_get", "options": { "reference_number": "QDi.001" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "scsanctions-un-org", "capability": "sanctions/records_get", "options": { "reference_number": "QDi.001" } } }' ``` ### CLI ```sh firecrawl scrape 'scsanctions-un-org/sanctions/records_get' \ --options '{"reference_number":"QDi.001"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "scsanctions-un-org", "capability": "sanctions/records_get", "options": { "reference_number": "QDi.001" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "scsanctions-un-org", "capability": "sanctions/records_get", "options": { "reference_number": "QDi.001" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "content_md5": "rkFlAPw3TJAVDd88vTutcw==", "etag": "0x8DF2CA2AF6F1B20", "file_size": 2185376, "file_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "lang": "en", "last_modified": "Sat, 17 Oct 2026 23:02:14 GMT", "observed_at_ms": 1792278282413, "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "published_at": "2026-10-17T23:00:01.054Z", "record": { "addresses": [], "birth_dates": [ { "date": "1963-04-11", "type": "EXACT" }, { "date": "1960-04-11", "type": "EXACT" } ], "birth_places": [ { "country": "Egypt", "state_province": "Monufia Governate" } ], "dataid": "113219", "derived": [ "measures", "legal_basis" ], "designations": [], "entity_type": "person", "identifiers": [], "interpol_link": "https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals#2012-312380", "last_reviewed": [ "2010-06-15", "2019-02-21", "2022-11-08" ], "last_updated": [ "2010-12-16", "2013-07-24", "2017-02-15", "2019-03-29", "2019-05-01", "2022-11-08", "2026-08-13" ], "legal_basis": [ "S/RES/1267 (1999)", "S/RES/1989 (2011)", "S/RES/2253 (2015)" ], "list_type": "UN List", "listed_on": "2001-01-25", "measures": [ "asset_freeze", "travel_ban", "arms_embargo" ], "names": [ { "name": "MOHAMMED SALAHALDIN ABD EL HALIM ZIDANE", "script": "Latn", "type": "primary" }, { "name": "محمد صلاح الدين عبدالحليم زيدان", "script": "Arab", "type": "primary" }, { "name": "Sayf-Al Adl", "note": "DOB: 11 Apr. 1963. POB: Monufia Governorate, Egypt. Nationality: Egypt. In Arabic: سيف العدل", "quality": "Good", "script": "Latn", "type": "alias" }, { "name": "Muhamad Ibrahim Makkawi", "note": "DOB: a) 11 Apr. 1960 b) 11 Apr. 1963. POB: Egypt. Nationality: Egypt", "quality": "Good", "script": "Latn", "type": "alias" }, { "name": "Ibrahim al-Madani", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "Saif Al-'Adil", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "Seif al Adel", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "SALEM AL-SHARIF", "note": "سالم الشريف", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "HAZEM AL-MADANI", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "ABER SABIL", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "MUHANNAD SALEM", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "ABU KHALED AL-SAN’ANI", "quality": "Low", "script": "Latn", "type": "weak" } ], "nationalities": [ "Egypt" ], "primary_name": "MOHAMMED SALAHALDIN ABD EL HALIM ZIDANE", "programs": [ "Al-Qaida" ], "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "regime": { "committee": "ISIL (Da'esh) and Al-Qaida Sanctions Committee (1267/1989/2253)", "name": "Al-Qaida", "slug": "al-qaida" }, "remarks": "Responsible for Usama bin Laden’s (deceased) security. Hair: Dark. Eyes: Dark. Photo available for inclusion in the INTERPOL-UN Security Council Special Notice INTERPOL-UN Security Council Special Notice:https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals", "retrieved_at": "2026-10-17T23:04:42Z", "source_record_id": "un:QDi.001", "source_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "titles": [], "un_reference": "QDi.001", "version_num": "1" }, "retrieved_at": "2026-10-17T23:04:42Z" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Records get - Capability: `sanctions/records_get` - Description: One record by the source's own id: `reference_number` (the permanent reference number, QDi.001 / KPe.001 / IRi.043 ..., case-insensitive) or `dataid` (the numeric DATAID), exactly one of them. The file is fetched and the record selected in memory (no per-record page exists upstream); an id not in the current publication is not_found. The answer carries the publication fields so the record can be tied to a snapshot. - Instructions: Look up one UN-listed party by its UN reference number (the key shared with EU, UK and Japan records of UN-derived listings) or DATAID. - Cost: 5 credits per call - Capability file: [Records get](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/sanctions/records_get) Accepted options: - `dataid` (string): Numeric DATAID, e.g. 113219. Pattern: ^[0-9]+$. Example: `` - `lang` (string): 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. Example: `en` - `reference_number` (string): Permanent reference number, e.g. QDi.001 (prefix = regime, i = individual, e = entity). Example: `` Response schema example: ```json { "content_md5": "rkFlAPw3TJAVDd88vTutcw==", "etag": "0x8DF2CA2AF6F1B20", "file_size": 2185376, "file_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "lang": "en", "last_modified": "Sat, 17 Oct 2026 23:02:14 GMT", "observed_at_ms": 1792278282413, "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "published_at": "2026-10-17T23:00:01.054Z", "record": { "addresses": [], "birth_dates": [ { "date": "1963-04-11", "type": "EXACT" }, { "date": "1960-04-11", "type": "EXACT" } ], "birth_places": [ { "country": "Egypt", "state_province": "Monufia Governate" } ], "dataid": "113219", "derived": [ "measures", "legal_basis" ], "designations": [], "entity_type": "person", "identifiers": [], "interpol_link": "https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals#2012-312380", "last_reviewed": [ "2010-06-15", "2019-02-21", "2022-11-08" ], "last_updated": [ "2010-12-16", "2013-07-24", "2017-02-15", "2019-03-29", "2019-05-01", "2022-11-08", "2026-08-13" ], "legal_basis": [ "S/RES/1267 (1999)", "S/RES/1989 (2011)", "S/RES/2253 (2015)" ], "list_type": "UN List", "listed_on": "2001-01-25", "measures": [ "asset_freeze", "travel_ban", "arms_embargo" ], "names": [ { "name": "MOHAMMED SALAHALDIN ABD EL HALIM ZIDANE", "script": "Latn", "type": "primary" }, { "name": "محمد صلاح الدين عبدالحليم زيدان", "script": "Arab", "type": "primary" }, { "name": "Sayf-Al Adl", "note": "DOB: 11 Apr. 1963. POB: Monufia Governorate, Egypt. Nationality: Egypt. In Arabic: سيف العدل", "quality": "Good", "script": "Latn", "type": "alias" }, { "name": "Muhamad Ibrahim Makkawi", "note": "DOB: a) 11 Apr. 1960 b) 11 Apr. 1963. POB: Egypt. Nationality: Egypt", "quality": "Good", "script": "Latn", "type": "alias" }, { "name": "Ibrahim al-Madani", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "Saif Al-'Adil", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "Seif al Adel", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "SALEM AL-SHARIF", "note": "سالم الشريف", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "HAZEM AL-MADANI", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "ABER SABIL", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "MUHANNAD SALEM", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "ABU KHALED AL-SAN’ANI", "quality": "Low", "script": "Latn", "type": "weak" } ], "nationalities": [ "Egypt" ], "primary_name": "MOHAMMED SALAHALDIN ABD EL HALIM ZIDANE", "programs": [ "Al-Qaida" ], "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "regime": { "committee": "ISIL (Da'esh) and Al-Qaida Sanctions Committee (1267/1989/2253)", "name": "Al-Qaida", "slug": "al-qaida" }, "remarks": "Responsible for Usama bin Laden’s (deceased) security. Hair: Dark. Eyes: Dark. Photo available for inclusion in the INTERPOL-UN Security Council Special Notice INTERPOL-UN Security Council Special Notice:https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals", "retrieved_at": "2026-10-17T23:04:42Z", "source_record_id": "un:QDi.001", "source_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "titles": [], "un_reference": "QDi.001", "version_num": "1" }, "retrieved_at": "2026-10-17T23:04:42Z" } ``` ### Records list - Capability: `sanctions/records_list` - Description: The full current list of one language edition, paginated in file order (INDIVIDUALS then ENTITIES, each by permanent reference number) and optionally filtered by regime (UN_LIST_TYPE or slug) and entity_type. Every page re-fetches the file (the runner keeps no state) and pins its canonical publication_id in the cursor; when the publisher has moved on, the next page fails with invalid_input and issue code `publication_changed` on /continuation instead of mixing publications: restart from the first page. A continuation overrides the filters (passing different ones is `cursor_mismatch`). A regime with no records of the requested type (e.g. GB organizations) is a legitimate empty page with total 0. Each record carries source_record_id (un:), source_url, publication_id and retrieved_at; measures and legal_basis are derived from the regime table (`derived` names them). - Instructions: Collect the whole UN consolidated list, or all records of one regime / type, as a snapshot tied to one publication. - Cost: 5 credits per call - Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/sanctions/records_list) Accepted options: - `continuation` (string): The cursor returned in meta.page.next_cursor of the previous page. Example: `` - `entity_type` (string): Record type filter: person (the file's INDIVIDUALS) or organization (ENTITIES). Example: `person` - `lang` (string): 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. Example: `en` - `page_size` (number): Records per page (default 100, max 200). Example: `100` - `regime` (string): Regime filter: a UN_LIST_TYPE value (Al-Qaida, Taliban, DPRK, Iraq, DRC, Iran, Libya, Somalia, CAR, Sudan, GB, Yemen, Haiti, SouthSudan) or its scsanctions.un.org slug (al-qaida, dprk, southsudan ...), case-insensitive. Unknown values are invalid_input. Example: `` Response schema example: ```json { "content_md5": "rkFlAPw3TJAVDd88vTutcw==", "entity_type": "organization", "etag": "0x8DF2CA2AF6F1B20", "file_size": 2185376, "file_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "lang": "en", "last_modified": "Sat, 17 Oct 2026 23:02:14 GMT", "observed_at_ms": 1792278275303, "offset": 0, "page_size": 3, "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "published_at": "2026-10-17T23:00:01.054Z", "records": [ { "addresses": [ { "city": "Pyongyang", "country": "Democratic People's Republic of Korea", "street": "Central District" } ], "birth_dates": [], "birth_places": [], "dataid": "690735", "derived": [ "measures", "legal_basis" ], "designations": [], "entity_type": "organization", "identifiers": [], "last_reviewed": [], "last_updated": [], "legal_basis": [ "S/RES/1718 (2006)" ], "list_type": "UN List", "listed_on": "2009-04-24", "measures": [ "asset_freeze" ], "names": [ { "name": "KOREA MINING DEVELOPMENT TRADING CORPORATION", "script": "Latn", "type": "primary" }, { "name": "CHANGGWANG SINYONG CORPORATION", "quality": "a.k.a.", "script": "Latn", "type": "alias" }, { "name": "EXTERNAL TECHNOLOGY GENERAL CORPORATION", "quality": "a.k.a.", "script": "Latn", "type": "alias" }, { "name": "DPRKN MINING DEVELOPMENT TRADING COOPERATION", "quality": "a.k.a.", "script": "Latn", "type": "alias" }, { "name": "\"KOMID\"", "quality": "a.k.a.", "script": "Latn", "type": "alias" } ], "nationalities": [], "primary_name": "KOREA MINING DEVELOPMENT TRADING CORPORATION", "programs": [ "DPRK" ], "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "regime": { "committee": "1718 Sanctions Committee", "name": "DPRK", "slug": "dprk" }, "remarks": "Primary arms dealer and main exporter of goods and equipment related to ballistic missiles and conventional weapons.", "retrieved_at": "2026-10-17T23:04:35Z", "source_record_id": "un:KPe.001", "source_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "titles": [], "un_reference": "KPe.001", "version_num": "1" }, { "addresses": [ { "city": "Pyongyang", "country": "Democratic People's Republic of Korea", "street": "Pot’onggang District" }, { "city": "Pyongyang", "country": "Democratic People's Republic of Korea", "street": "Rakwon-dong, Pothonggang District" } ], "birth_dates": [], "birth_places": [], "dataid": "690751", "derived": [ "measures", "legal_basis" ], "designations": [], "entity_type": "organization", "identifiers": [], "last_reviewed": [], "last_updated": [], "legal_basis": [ "S/RES/1718 (2006)" ], "list_type": "UN List", "listed_on": "2009-04-24", "measures": [ "asset_freeze" ], "names": [ { "name": "KOREA RYONBONG GENERAL CORPORATION", "script": "Latn", "type": "primary" }, { "name": "KOREA YONBONG GENERAL CORPORATION", "quality": "a.k.a.", "script": "Latn", "type": "alias" }, { "name": "LYONGAKSAN GENERAL TRADING CORPORATION", "quality": "f.k.a.", "script": "Latn", "type": "former" } ], "nationalities": [], "primary_name": "KOREA RYONBONG GENERAL CORPORATION", "programs": [ "DPRK" ], "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "regime": { "committee": "1718 Sanctions Committee", "name": "DPRK", "slug": "dprk" }, "remarks": "Defense conglomerate specializing in acquisition for DPRK defense industries and support to that country’s military-related sales.", "retrieved_at": "2026-10-17T23:04:35Z", "source_record_id": "un:KPe.002", "source_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "titles": [], "un_reference": "KPe.002", "version_num": "1" }, { "addresses": [ { "city": "Pyongyang", "country": "Democratic People's Republic of Korea", "street": "Saemul 1-Dong Pyongchon District" } ], "birth_dates": [], "birth_places": [], "dataid": "690752", "derived": [ "measures", "legal_basis" ], "designations": [], "entity_type": "organization", "identifiers": [], "last_reviewed": [], "last_updated": [], "legal_basis": [ "S/RES/1718 (2006)" ], "list_type": "UN List", "listed_on": "2009-04-24", "measures": [ "asset_freeze" ], "names": [ { "name": "TANCHON COMMERCIAL BANK", "script": "Latn", "type": "primary" }, { "name": "CHANGGWANG CREDIT BANK", "quality": "f.k.a.", "script": "Latn", "type": "former" }, { "name": "KOREA CHANGGWANG CREDIT BANK", "quality": "f.k.a.", "script": "Latn", "type": "former" } ], "nationalities": [], "primary_name": "TANCHON COMMERCIAL BANK", "programs": [ "DPRK" ], "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "regime": { "committee": "1718 Sanctions Committee", "name": "DPRK", "slug": "dprk" }, "remarks": "Main DPRK financial entity for sales of conventional arms, ballistic missiles, and goods related to the assembly and manufacture of such weapons.", "retrieved_at": "2026-10-17T23:04:35Z", "source_record_id": "un:KPe.003", "source_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "titles": [], "un_reference": "KPe.003", "version_num": "1" } ], "regime": "DPRK", "retrieved_at": "2026-10-17T23:04:35Z", "total": 75 } ``` ### Search - Capability: `sanctions/search` - Description: Name search over one language edition, in memory (the site has no search): case-insensitive substring match on the primary name, the original-script name and every alias, plus exact match on the reference number or DATAID; optional regime and entity_type filters. `total` counts every match, `records` holds the first `limit` (default 20, max 100) in file order; a query matching nothing is a successful empty result (total 0). Use `lang: ar` (or fr, ru, sp, ch) to match names in that edition's script. Not a compliance determination. - Instructions: Screen a name against the UN Security Council Consolidated List and get reference numbers for records_get. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/sanctions/search) Accepted options: - `entity_type` (string): Record type filter: person (the file's INDIVIDUALS) or organization (ENTITIES). Example: `person` - `lang` (string): 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. Example: `en` - `limit` (number): limit Example: `20` - `q` (string, required): Name or name fragment (at least two characters), or a reference number / DATAID. Example: `` - `regime` (string): Regime filter: a UN_LIST_TYPE value (Al-Qaida, Taliban, DPRK, Iraq, DRC, Iran, Libya, Somalia, CAR, Sudan, GB, Yemen, Haiti, SouthSudan) or its scsanctions.un.org slug (al-qaida, dprk, southsudan ...), case-insensitive. Unknown values are invalid_input. Example: `` Response schema example: ```json { "content_md5": "rkFlAPw3TJAVDd88vTutcw==", "entity_type": null, "etag": "0x8DF2CA2AF6F1B20", "file_size": 2185376, "file_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "lang": "en", "last_modified": "Sat, 17 Oct 2026 23:02:14 GMT", "limit": 5, "observed_at_ms": 1792278289703, "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "published_at": "2026-10-17T23:00:01.054Z", "q": "Zidane", "records": [ { "addresses": [], "birth_dates": [ { "date": "1963-04-11", "type": "EXACT" }, { "date": "1960-04-11", "type": "EXACT" } ], "birth_places": [ { "country": "Egypt", "state_province": "Monufia Governate" } ], "dataid": "113219", "derived": [ "measures", "legal_basis" ], "designations": [], "entity_type": "person", "identifiers": [], "interpol_link": "https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals#2012-312380", "last_reviewed": [ "2010-06-15", "2019-02-21", "2022-11-08" ], "last_updated": [ "2010-12-16", "2013-07-24", "2017-02-15", "2019-03-29", "2019-05-01", "2022-11-08", "2026-08-13" ], "legal_basis": [ "S/RES/1267 (1999)", "S/RES/1989 (2011)", "S/RES/2253 (2015)" ], "list_type": "UN List", "listed_on": "2001-01-25", "measures": [ "asset_freeze", "travel_ban", "arms_embargo" ], "names": [ { "name": "MOHAMMED SALAHALDIN ABD EL HALIM ZIDANE", "script": "Latn", "type": "primary" }, { "name": "محمد صلاح الدين عبدالحليم زيدان", "script": "Arab", "type": "primary" }, { "name": "Sayf-Al Adl", "note": "DOB: 11 Apr. 1963. POB: Monufia Governorate, Egypt. Nationality: Egypt. In Arabic: سيف العدل", "quality": "Good", "script": "Latn", "type": "alias" }, { "name": "Muhamad Ibrahim Makkawi", "note": "DOB: a) 11 Apr. 1960 b) 11 Apr. 1963. POB: Egypt. Nationality: Egypt", "quality": "Good", "script": "Latn", "type": "alias" }, { "name": "Ibrahim al-Madani", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "Saif Al-'Adil", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "Seif al Adel", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "SALEM AL-SHARIF", "note": "سالم الشريف", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "HAZEM AL-MADANI", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "ABER SABIL", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "MUHANNAD SALEM", "quality": "Low", "script": "Latn", "type": "weak" }, { "name": "ABU KHALED AL-SAN’ANI", "quality": "Low", "script": "Latn", "type": "weak" } ], "nationalities": [ "Egypt" ], "primary_name": "MOHAMMED SALAHALDIN ABD EL HALIM ZIDANE", "programs": [ "Al-Qaida" ], "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "regime": { "committee": "ISIL (Da'esh) and Al-Qaida Sanctions Committee (1267/1989/2253)", "name": "Al-Qaida", "slug": "al-qaida" }, "remarks": "Responsible for Usama bin Laden’s (deceased) security. Hair: Dark. Eyes: Dark. Photo available for inclusion in the INTERPOL-UN Security Council Special Notice INTERPOL-UN Security Council Special Notice:https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals", "retrieved_at": "2026-10-17T23:04:49Z", "source_record_id": "un:QDi.001", "source_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "titles": [], "un_reference": "QDi.001", "version_num": "1" } ], "regime": null, "retrieved_at": "2026-10-17T23:04:49Z", "total": 1 } ``` ### Source status - Capability: `sanctions/source_status` - Description: Cheap version check of one language edition: GET the consolidated XML through its 302 (the signed Azure blob is followed at call time, never returned) and report the file's dateGenerated (published_at), the blob's Last-Modified, ETag and publisher-posted Content-MD5, the file URL and size, the canonical publication_id (SHA-256 over the records, stable across nightly regenerations that change nothing), record counts (total, individuals, entities) and per-regime counts. `changes_feed` is always false: the UN publishes no deltas. The whole 2.2 MB file is read because record counts and the canonical hash need it. - Instructions: Decide whether a new snapshot of the UN list is worth collecting, or get the publication_id to compare with a cursor or a previous collection. - Cost: 5 credits per call - Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/scsanctions-un-org/sanctions/source_status) Accepted options: - `lang` (string): 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. Example: `en` Response schema example: ```json { "changes_feed": false, "content_md5": "rkFlAPw3TJAVDd88vTutcw==", "entities": 274, "etag": "0x8DF2CA2AF6F1B20", "file_size": 2185376, "file_url": "https://scsanctions.un.org/resources/xml/en/consolidated.xml", "individuals": 736, "lang": "en", "last_modified": "Sat, 17 Oct 2026 23:02:14 GMT", "observed_at_ms": 1792278267852, "publication_id": "sha256:c78d0b3f4b9e6c700e56985af00b64f1f36e00d02286b2b439a07af7c5ee6719", "published_at": "2026-10-17T23:00:01.054Z", "record_count": 1010, "regimes": [ { "committee": "1533 Sanctions Committee", "entities": 11, "individuals": 50, "name": "DRC", "records": 61, "slug": "drc" }, { "committee": "2127 Sanctions Committee", "entities": 1, "individuals": 14, "name": "CAR", "records": 15, "slug": "car" }, { "committee": "2048 Sanctions Committee (Guinea-Bissau)", "entities": 0, "individuals": 10, "name": "GB", "records": 10, "slug": "gb" }, { "committee": "2653 Sanctions Committee", "entities": 2, "individuals": 9, "name": "Haiti", "records": 11, "slug": "haiti" }, { "committee": "1518 Sanctions Committee", "entities": 9, "individuals": 65, "name": "Iraq", "records": 74, "slug": "iraq" }, { "committee": "Resolution 2231 (2015) list", "entities": 78, "individuals": 43, "name": "Iran", "records": 121, "slug": "iran" }, { "committee": "1718 Sanctions Committee", "entities": 75, "individuals": 80, "name": "DPRK", "records": 155, "slug": "dprk" }, { "committee": "1970 Sanctions Committee", "entities": 3, "individuals": 28, "name": "Libya", "records": 31, "slug": "libya" }, { "committee": "ISIL (Da'esh) and Al-Qaida Sanctions Committee (1267/1989/2253)", "entities": 88, "individuals": 248, "name": "Al-Qaida", "records": 336, "slug": "al-qaida" }, { "committee": "1591 Sanctions Committee", "entities": 0, "individuals": 13, "name": "Sudan", "records": 13, "slug": "sudan" }, { "committee": "751 Sanctions Committee", "entities": 1, "individuals": 23, "name": "Somalia", "records": 24, "slug": "somalia" }, { "committee": "2206 Sanctions Committee", "entities": 0, "individuals": 8, "name": "SouthSudan", "records": 8, "slug": "southsudan" }, { "committee": "1988 Sanctions Committee", "entities": 5, "individuals": 135, "name": "Taliban", "records": 140, "slug": "taliban" }, { "committee": "2140 Sanctions Committee", "entities": 1, "individuals": 10, "name": "Yemen", "records": 11, "slug": "yemen" } ], "retrieved_at": "2026-10-17T23:04:27Z" } ```