---
type: "firecrawl-provider"
description: "The European Commission's consolidated list of persons, groups and entities subject to EU financial sanctions (Financial Sanctions Files, webgate.ec.europa.eu/fsd/fsf), read from the public XML 1.1 file and its RSS version feed: a cheap version check (publication id, date, size, publisher's SHA-1), the full list paginated with a cursor pinned to one publication, one entity by logicalId or EU reference number with every name (all languages and scripts), identifier, address, nationality, birth date and place, programme, legal basis and remark, and a name search. Primary source, anonymous, asset-freeze measure only; no change feed exists upstream (the feed only announces new full files), so records_changes is not offered. Reuse under Commission Decision 2011/833/EU. A match or an absence is not a compliance determination."
use_when: "The European Commission's consolidated list of persons, groups and entities subject to EU financial sanctions (Financial Sanctions Files, webgate.ec.europa.eu/fsd/fsf), read from the public XML 1.1 file and its RSS version feed: a cheap version check (publication id, date, size, publisher's SHA-1), the full list paginated with a cursor pinned to one publication, one entity by logicalId or EU reference number with every name (all languages and scripts), identifier, address, nationality, birth date and place, programme, legal basis and remark, and a name search. Primary source, anonymous, asset-freeze measure only; no change feed exists upstream (the feed only announces new full files), so records_changes is not offered. Reuse under Commission Decision 2011/833/EU. A match or an absence is not a compliance determination."
categories: "Public records"
capabilities: 4
credits_per_call: 5
---
# EU Financial Sanctions Files (consolidated list) on Firecrawl Alexandria

The European Commission's consolidated list of persons, groups and entities subject to EU financial sanctions (Financial Sanctions Files, webgate.ec.europa.eu/fsd/fsf), read from the public XML 1.1 file and its RSS version feed: a cheap version check (publication id, date, size, publisher's SHA-1), the full list paginated with a cursor pinned to one publication, one entity by logicalId or EU reference number with every name (all languages and scripts), identifier, address, nationality, birth date and place, programme, legal basis and remark, and a name search. Primary source, anonymous, asset-freeze measure only; no change feed exists upstream (the feed only announces new full files), so records_changes is not offered. Reuse under Commission Decision 2011/833/EU. 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: `webgate-ec-europa-eu`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/webgate-ec-europa-eu)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/openapi.json)

## Capabilities

- [Records get](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/sanctions/records_get): One entity of the consolidated list by its own identifier: `eu:<logicalId>` (the source_record_id), a bare logicalId, or the EU reference number (EU.n.n). Returns the full record (names in every language and script with their amendment reference, identifiers, addresses with contact details, nationalities, birth dates and places kept as partial or approximate as the file states them, programme, measures, legal basis with EUR-Lex links, designation date or its fallback, UN reference, designation details, remarks) plus the publication it was read from. There is no per-entity endpoint upstream: the call reads the feed and the current XML 1.1 file and stops at the matching entity. Fails with not_found when no entity in the current file carries the identifier.
- [Records list](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/sanctions/records_list): One page of the full consolidated list (XML 1.1), in file order (ascending logicalId), optionally filtered by programme code (UKR, IRN, SYR, ... 34 codes in the current file) and entity type (person, organization). The cursor is pinned to the publication (the file's SHA-1): every page re-reads the feed and the file, and when the publication has moved on the call fails with invalid_input, issue code `publication_changed`, instead of mixing two versions; restart without a cursor. Each record carries source_record_id (eu:<logicalId>), entity_type, primary_name, names (all languages and scripts), identifiers, addresses, nationalities, birth_dates (partial and approximate kept as given), birth_places, programs, measures (always asset_freeze), legal_basis, listed_on (designationDate, or the earliest amendment date when the file omits it), un_reference, remarks, and the provenance fields source_url, publication_id, retrieved_at. `total` counts the entities matching the filter in the whole file; `publication.record_count` is the file's entity count. Every page costs one feed request and one gzip-compressed download of the 25 MB file (about 2.5 MB on the wire), so prefer large pages (up to 500).
- [Search](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/sanctions/search): Name search over the current consolidated list: every whitespace-separated term of `q` must occur (case-insensitive substring) in one of an entity's names, in any language or script (nameAlias wholeName). Optional programme and entity_type filters. Returns compact hits in file order (source_record_id, EU reference number, entity type, primary name, the names that matched, programmes, listing date, UN reference); records_get has the full record. `total` counts every matching entity; when it exceeds `limit` the result is marked partial. An empty result is a legitimate answer (no name contains the terms), not an error. A match or an absence is not a compliance determination.
- [Source status](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/sanctions/source_status): Cheap version check from the RSS feed (one 4 KB request, no file download): the current XML 1.1 publication's id (the publisher's SHA-1 checksum of the file, from the feed's guid), publication date, file resource URL (without the public access query parameter the feed prints; see file_url), size in bytes and content hash, plus the same for every published file (PDF 1.0, CSV 1.0, CSV 1.1, XML 1.1, XML 1.0). The record count is not returned here because it needs the 25 MB file; records_list returns it. Use the publication_id to decide whether a held snapshot is stale.

## 1. Choose this provider when

The European Commission's consolidated list of persons, groups and entities subject to EU financial sanctions (Financial Sanctions Files, webgate.ec.europa.eu/fsd/fsf), read from the public XML 1.1 file and its RSS version feed: a cheap version check (publication id, date, size, publisher's SHA-1), the full list paginated with a cursor pinned to one publication, one entity by logicalId or EU reference number with every name (all languages and scripts), identifier, address, nationality, birth date and place, programme, legal basis and remark, and a name search. Primary source, anonymous, asset-freeze measure only; no change feed exists upstream (the feed only announces new full files), so records_changes is not offered. Reuse under Commission Decision 2011/833/EU. 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": "webgate-ec-europa-eu",
  "capability": "sanctions/records_get",
  "options": {
    "id": "eu:6106"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `id` (string, required): `eu:6106`, `6106` or `EU.3886.3`. Example: `eu:6106`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "webgate-ec-europa-eu",
    capability: "sanctions/records_get",
    options: {
      id: "eu:6106",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "webgate-ec-europa-eu",
  "capability": "sanctions/records_get",
  "options": {
    "id": "eu:6106"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "webgate-ec-europa-eu",
    "capability": "sanctions/records_get",
    "options": {
      "id": "eu:6106"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'webgate-ec-europa-eu/sanctions/records_get' \
  --options '{"id":"eu:6106"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "webgate-ec-europa-eu",
  "capability": "sanctions/records_get",
  "options": {
    "id": "eu:6106"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "webgate-ec-europa-eu",
  "capability": "sanctions/records_get",
  "options": {
    "id": "eu:6106"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "addresses": [
    {
      "as_at_listing_time": false,
      "city": null,
      "contact": [],
      "country": {
        "iso2": "LY",
        "name": "LIBYA"
      },
      "logical_id": 107521,
      "place": null,
      "po_box": null,
      "region": null,
      "regulation": {
        "number_title": "2020/371 (OJ L71)",
        "publication_date": "2020-03-06",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32020R0371&from=EN",
        "regulation_type": "amendment"
      },
      "remarks": [
        "Libya (Believed status/location: residing in Egypt)"
      ],
      "street": null,
      "zip_code": null
    }
  ],
  "birth_dates": [
    {
      "calendar_type": "GREGORIAN",
      "circa": false,
      "date": "1944-04-04",
      "day": 4,
      "logical_id": 111613,
      "month": 4,
      "regulation": {
        "number_title": "2020/371 (OJ L71)",
        "publication_date": "2020-03-06",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32020R0371&from=EN",
        "regulation_type": "amendment"
      },
      "remarks": [],
      "year": 1944,
      "year_from": null,
      "year_to": null
    }
  ],
  "birth_places": [
    {
      "city": null,
      "country": null,
      "logical_id": 111613,
      "place": "Alrhaybat",
      "region": null,
      "zip_code": null
    }
  ],
  "designation_details": null,
  "entity_type": "person",
  "eu_reference_number": "EU.3886.3",
  "identifiers": [
    {
      "diplomatic": false,
      "issue_date": "2018-11-25",
      "issued_by": null,
      "issuing_country": {
        "iso2": "LY",
        "name": "LIBYA"
      },
      "known_expired": false,
      "known_false": false,
      "latin_value": null,
      "logical_id": 122749,
      "name_on_document": null,
      "region": "Tripoli",
      "regulation": {
        "number_title": "2020/371 (OJ L71)",
        "publication_date": "2020-03-06",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32020R0371&from=EN",
        "regulation_type": "amendment"
      },
      "remarks": [],
      "reported_lost": false,
      "revoked_by_issuer": false,
      "scheme": "passport",
      "scheme_description": "National passport",
      "valid_from": null,
      "valid_to": "2026-11-24",
      "value": "FK117RK0"
    }
  ],
  "legal_basis": [
    {
      "entry_into_force_date": "2022-09-13",
      "number_title": "2022/1502 (OJ L235)",
      "organisation_type": "council",
      "programme": "LBY",
      "publication_date": "2022-09-12",
      "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2022.235.01.0004.01.ENG&toc=OJ%3AL%3A2022%3A235%3ATOC",
      "regulation_type": "amendment"
    }
  ],
  "listed_on": "2011-02-26",
  "listed_on_source": "designation_date",
  "logical_id": 6106,
  "measures": [
    "asset_freeze"
  ],
  "names": [
    {
      "first_name": "Abu",
      "function": "Director, External Security Organisation. Head of external intelligence agency.",
      "gender": null,
      "language": null,
      "last_name": "DORDA",
      "logical_id": 8986,
      "middle_name": "Zayd Umar",
      "name": "Abu Zayd Umar DORDA",
      "regulation": {
        "number_title": "1103/2014 (OJ L301)",
        "publication_date": "2014-10-20",
        "publication_url": "http://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=OJ:JOL_2014_301_R_0002&from=EN",
        "regulation_type": "amendment"
      },
      "regulation_language": "en",
      "remarks": [],
      "strong": true,
      "title": null,
      "type": "primary"
    },
    {
      "first_name": null,
      "function": null,
      "gender": null,
      "language": null,
      "last_name": null,
      "logical_id": 122750,
      "middle_name": null,
      "name": "Dorda Abuzed OE",
      "regulation": {
        "number_title": "2020/371 (OJ L71)",
        "publication_date": "2020-03-06",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32020R0371&from=EN",
        "regulation_type": "amendment"
      },
      "regulation_language": "en",
      "remarks": [
        "Good quality alias"
      ],
      "strong": true,
      "title": null,
      "type": "alias"
    },
    {
      "first_name": null,
      "function": null,
      "gender": null,
      "language": null,
      "last_name": null,
      "logical_id": 143087,
      "middle_name": null,
      "name": "Abu  Zayd Umar Hmeid Dorda",
      "regulation": {
        "number_title": "2022/1502 (OJ L235)",
        "publication_date": "2022-09-12",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2022.235.01.0004.01.ENG&toc=OJ%3AL%3A2022%3A235%3ATOC",
        "regulation_type": "amendment"
      },
      "regulation_language": "en",
      "remarks": [
        "Good quality alias"
      ],
      "strong": true,
      "title": null,
      "type": "alias"
    },
    {
      "first_name": null,
      "function": null,
      "gender": null,
      "language": "CS",
      "last_name": null,
      "logical_id": 143588,
      "middle_name": null,
      "name": "ABÚ ZAJD UMAR DÚRDA",
      "regulation": {
        "number_title": "2022/1502 (OJ L235)",
        "publication_date": "2022-09-12",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2022.235.01.0004.01.ENG&toc=OJ%3AL%3A2022%3A235%3ATOC",
        "regulation_type": "amendment"
      },
      "regulation_language": "en",
      "remarks": [],
      "strong": true,
      "title": null,
      "type": "alias"
    }
  ],
  "nationalities": [],
  "observed_at_ms": 1792279132914,
  "primary_name": "Abu Zayd Umar DORDA",
  "programs": [
    "LBY"
  ],
  "publication": {
    "content_hash": {
      "algorithm": "sha1",
      "value": "0BA673508859A90863F5BDBEDD14F36A23A6F65C"
    },
    "file_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
    "generation_date": "2026-10-15T12:10:34.160+02:00",
    "global_file_id": "185699",
    "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
    "published_at": "2026-10-15T10:20:12Z",
    "size_bytes": 25767041
  },
  "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
  "remarks": [
    "Listed pursuant to paragraph 15 of resolution 1970 (Travel Ban). Listed on 17 March 2011 pursuant to paragraph 17 of resolution 1970 (Asset Freeze)."
  ],
  "retrieved_at": "2026-10-17T23:18:52Z",
  "source_record_id": "eu:6106",
  "source_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
  "subject_type": {
    "classification_code": "P",
    "code": "person"
  },
  "un_reference": "LYi.006"
}
```

## 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 entity of the consolidated list by its own identifier: `eu:<logicalId>` (the source_record_id), a bare logicalId, or the EU reference number (EU.n.n). Returns the full record (names in every language and script with their amendment reference, identifiers, addresses with contact details, nationalities, birth dates and places kept as partial or approximate as the file states them, programme, measures, legal basis with EUR-Lex links, designation date or its fallback, UN reference, designation details, remarks) plus the publication it was read from. There is no per-entity endpoint upstream: the call reads the feed and the current XML 1.1 file and stops at the matching entity. Fails with not_found when no entity in the current file carries the identifier.
- Instructions: You have a source_record_id, logicalId or EU reference number (from records_list, search or a downstream table) and want the complete current record.
- Cost: 5 credits per call
- Capability file: [Records get](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/sanctions/records_get)

Accepted options:
- `id` (string, required): `eu:6106`, `6106` or `EU.3886.3`. Example: `eu:6106`

Response schema example:
```json
{
  "addresses": [
    {
      "as_at_listing_time": false,
      "city": null,
      "contact": [],
      "country": {
        "iso2": "LY",
        "name": "LIBYA"
      },
      "logical_id": 107521,
      "place": null,
      "po_box": null,
      "region": null,
      "regulation": {
        "number_title": "2020/371 (OJ L71)",
        "publication_date": "2020-03-06",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32020R0371&from=EN",
        "regulation_type": "amendment"
      },
      "remarks": [
        "Libya (Believed status/location: residing in Egypt)"
      ],
      "street": null,
      "zip_code": null
    }
  ],
  "birth_dates": [
    {
      "calendar_type": "GREGORIAN",
      "circa": false,
      "date": "1944-04-04",
      "day": 4,
      "logical_id": 111613,
      "month": 4,
      "regulation": {
        "number_title": "2020/371 (OJ L71)",
        "publication_date": "2020-03-06",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32020R0371&from=EN",
        "regulation_type": "amendment"
      },
      "remarks": [],
      "year": 1944,
      "year_from": null,
      "year_to": null
    }
  ],
  "birth_places": [
    {
      "city": null,
      "country": null,
      "logical_id": 111613,
      "place": "Alrhaybat",
      "region": null,
      "zip_code": null
    }
  ],
  "designation_details": null,
  "entity_type": "person",
  "eu_reference_number": "EU.3886.3",
  "identifiers": [
    {
      "diplomatic": false,
      "issue_date": "2018-11-25",
      "issued_by": null,
      "issuing_country": {
        "iso2": "LY",
        "name": "LIBYA"
      },
      "known_expired": false,
      "known_false": false,
      "latin_value": null,
      "logical_id": 122749,
      "name_on_document": null,
      "region": "Tripoli",
      "regulation": {
        "number_title": "2020/371 (OJ L71)",
        "publication_date": "2020-03-06",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32020R0371&from=EN",
        "regulation_type": "amendment"
      },
      "remarks": [],
      "reported_lost": false,
      "revoked_by_issuer": false,
      "scheme": "passport",
      "scheme_description": "National passport",
      "valid_from": null,
      "valid_to": "2026-11-24",
      "value": "FK117RK0"
    }
  ],
  "legal_basis": [
    {
      "entry_into_force_date": "2022-09-13",
      "number_title": "2022/1502 (OJ L235)",
      "organisation_type": "council",
      "programme": "LBY",
      "publication_date": "2022-09-12",
      "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2022.235.01.0004.01.ENG&toc=OJ%3AL%3A2022%3A235%3ATOC",
      "regulation_type": "amendment"
    }
  ],
  "listed_on": "2011-02-26",
  "listed_on_source": "designation_date",
  "logical_id": 6106,
  "measures": [
    "asset_freeze"
  ],
  "names": [
    {
      "first_name": "Abu",
      "function": "Director, External Security Organisation. Head of external intelligence agency.",
      "gender": null,
      "language": null,
      "last_name": "DORDA",
      "logical_id": 8986,
      "middle_name": "Zayd Umar",
      "name": "Abu Zayd Umar DORDA",
      "regulation": {
        "number_title": "1103/2014 (OJ L301)",
        "publication_date": "2014-10-20",
        "publication_url": "http://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=OJ:JOL_2014_301_R_0002&from=EN",
        "regulation_type": "amendment"
      },
      "regulation_language": "en",
      "remarks": [],
      "strong": true,
      "title": null,
      "type": "primary"
    },
    {
      "first_name": null,
      "function": null,
      "gender": null,
      "language": null,
      "last_name": null,
      "logical_id": 122750,
      "middle_name": null,
      "name": "Dorda Abuzed OE",
      "regulation": {
        "number_title": "2020/371 (OJ L71)",
        "publication_date": "2020-03-06",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32020R0371&from=EN",
        "regulation_type": "amendment"
      },
      "regulation_language": "en",
      "remarks": [
        "Good quality alias"
      ],
      "strong": true,
      "title": null,
      "type": "alias"
    },
    {
      "first_name": null,
      "function": null,
      "gender": null,
      "language": null,
      "last_name": null,
      "logical_id": 143087,
      "middle_name": null,
      "name": "Abu  Zayd Umar Hmeid Dorda",
      "regulation": {
        "number_title": "2022/1502 (OJ L235)",
        "publication_date": "2022-09-12",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2022.235.01.0004.01.ENG&toc=OJ%3AL%3A2022%3A235%3ATOC",
        "regulation_type": "amendment"
      },
      "regulation_language": "en",
      "remarks": [
        "Good quality alias"
      ],
      "strong": true,
      "title": null,
      "type": "alias"
    },
    {
      "first_name": null,
      "function": null,
      "gender": null,
      "language": "CS",
      "last_name": null,
      "logical_id": 143588,
      "middle_name": null,
      "name": "ABÚ ZAJD UMAR DÚRDA",
      "regulation": {
        "number_title": "2022/1502 (OJ L235)",
        "publication_date": "2022-09-12",
        "publication_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2022.235.01.0004.01.ENG&toc=OJ%3AL%3A2022%3A235%3ATOC",
        "regulation_type": "amendment"
      },
      "regulation_language": "en",
      "remarks": [],
      "strong": true,
      "title": null,
      "type": "alias"
    }
  ],
  "nationalities": [],
  "observed_at_ms": 1792279132914,
  "primary_name": "Abu Zayd Umar DORDA",
  "programs": [
    "LBY"
  ],
  "publication": {
    "content_hash": {
      "algorithm": "sha1",
      "value": "0BA673508859A90863F5BDBEDD14F36A23A6F65C"
    },
    "file_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
    "generation_date": "2026-10-15T12:10:34.160+02:00",
    "global_file_id": "185699",
    "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
    "published_at": "2026-10-15T10:20:12Z",
    "size_bytes": 25767041
  },
  "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
  "remarks": [
    "Listed pursuant to paragraph 15 of resolution 1970 (Travel Ban). Listed on 17 March 2011 pursuant to paragraph 17 of resolution 1970 (Asset Freeze)."
  ],
  "retrieved_at": "2026-10-17T23:18:52Z",
  "source_record_id": "eu:6106",
  "source_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
  "subject_type": {
    "classification_code": "P",
    "code": "person"
  },
  "un_reference": "LYi.006"
}
```

### Records list

- Capability: `sanctions/records_list`
- Description: One page of the full consolidated list (XML 1.1), in file order (ascending logicalId), optionally filtered by programme code (UKR, IRN, SYR, ... 34 codes in the current file) and entity type (person, organization). The cursor is pinned to the publication (the file's SHA-1): every page re-reads the feed and the file, and when the publication has moved on the call fails with invalid_input, issue code `publication_changed`, instead of mixing two versions; restart without a cursor. Each record carries source_record_id (eu:<logicalId>), entity_type, primary_name, names (all languages and scripts), identifiers, addresses, nationalities, birth_dates (partial and approximate kept as given), birth_places, programs, measures (always asset_freeze), legal_basis, listed_on (designationDate, or the earliest amendment date when the file omits it), un_reference, remarks, and the provenance fields source_url, publication_id, retrieved_at. `total` counts the entities matching the filter in the whole file; `publication.record_count` is the file's entity count. Every page costs one feed request and one gzip-compressed download of the 25 MB file (about 2.5 MB on the wire), so prefer large pages (up to 500).
- Instructions: Collect the whole current list, or every entity of one programme, into a downstream table; chain pages with next_cursor until it is null.
- Cost: 5 credits per call
- Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/sanctions/records_list)

Accepted options:
- `cursor` (string): next_cursor of the previous page. Opaque; pinned to the publication the first page came from. Example: `<cursor>`
- `entity_type` (string): Keep only persons (subjectType person) or organizations (subjectType enterprise). Example: `person`
- `page_size` (number): Entities per page (default 200). A record is 1 to 60 KB of JSON; 500 entities of the list are roughly 2.5 MB. Example: `200`
- `programme` (string): Regulation programme code as written in the file (UKR, IRN, SYR, BLR, TAQA, PRK, ...). Case-insensitive. An unknown code fails with invalid_input listing the codes in the file. Example: `<programme>`

Response schema example:
```json
{
  "count": 2,
  "filter": {
    "entity_type": null,
    "programme": null
  },
  "next_cursor": "v1.0BA673508859A90863F5BDBEDD14F36A23A6F65C.2",
  "observed_at_ms": 1792279116052,
  "offset": 0,
  "page_size": 2,
  "publication": {
    "content_hash": {
      "algorithm": "sha1",
      "value": "0BA673508859A90863F5BDBEDD14F36A23A6F65C"
    },
    "file_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
    "generation_date": "2026-10-15T12:10:34.160+02:00",
    "global_file_id": "185699",
    "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
    "published_at": "2026-10-15T10:20:12Z",
    "record_count": 6234,
    "size_bytes": 25767041
  },
  "records": [
    {
      "addresses": [],
      "birth_dates": [
        {
          "calendar_type": "GREGORIAN",
          "circa": false,
          "date": "1937-04-28",
          "day": 28,
          "logical_id": 14,
          "month": 4,
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "remarks": [],
          "year": 1937,
          "year_from": null,
          "year_to": null
        }
      ],
      "birth_places": [
        {
          "city": "al-Awja, near Tikrit",
          "country": {
            "iso2": "IQ",
            "name": "IRAQ"
          },
          "logical_id": 14,
          "place": null,
          "region": null,
          "zip_code": null
        }
      ],
      "designation_details": null,
      "entity_type": "person",
      "eu_reference_number": "EU.27.28",
      "identifiers": [],
      "legal_basis": [
        {
          "entry_into_force_date": "2003-07-07",
          "number_title": "1210/2003 (OJ L169)",
          "organisation_type": "commission",
          "programme": "IRQ",
          "publication_date": "2003-07-08",
          "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
          "regulation_type": "regulation"
        }
      ],
      "listed_on": "2003-07-08",
      "listed_on_source": "earliest_regulation_summary",
      "logical_id": 13,
      "measures": [
        "asset_freeze"
      ],
      "names": [
        {
          "first_name": "Saddam",
          "function": null,
          "gender": "M",
          "language": null,
          "last_name": "Hussein Al-Tikriti",
          "logical_id": 17,
          "middle_name": null,
          "name": "Saddam Hussein Al-Tikriti",
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "regulation_language": "en",
          "remarks": [],
          "strong": true,
          "title": null,
          "type": "primary"
        },
        {
          "first_name": null,
          "function": null,
          "gender": null,
          "language": null,
          "last_name": null,
          "logical_id": 19,
          "middle_name": null,
          "name": "Abu Ali",
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "regulation_language": "en",
          "remarks": [],
          "strong": true,
          "title": null,
          "type": "alias"
        },
        {
          "first_name": null,
          "function": null,
          "gender": null,
          "language": "FR",
          "last_name": null,
          "logical_id": 380,
          "middle_name": null,
          "name": "Abou Ali",
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "regulation_language": "en",
          "remarks": [],
          "strong": true,
          "title": null,
          "type": "alias"
        }
      ],
      "nationalities": [
        {
          "country": {
            "iso2": "IQ",
            "name": "IRAQ"
          },
          "logical_id": 1,
          "region": null,
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "remarks": []
        }
      ],
      "primary_name": "Saddam Hussein Al-Tikriti",
      "programs": [
        "IRQ"
      ],
      "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
      "remarks": [
        "UNSC RESOLUTION 1483"
      ],
      "retrieved_at": "2026-10-17T23:18:35Z",
      "source_record_id": "eu:13",
      "source_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
      "subject_type": {
        "classification_code": "P",
        "code": "person"
      },
      "un_reference": null
    },
    {
      "addresses": [],
      "birth_dates": [
        {
          "calendar_type": "GREGORIAN",
          "circa": false,
          "date": null,
          "day": null,
          "logical_id": 19,
          "month": null,
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "remarks": [],
          "year": 1965,
          "year_from": null,
          "year_to": null
        },
        {
          "calendar_type": "GREGORIAN",
          "circa": false,
          "date": null,
          "day": null,
          "logical_id": 20,
          "month": null,
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "remarks": [],
          "year": 1966,
          "year_from": null,
          "year_to": null
        }
      ],
      "birth_places": [
        {
          "city": "Baghdad",
          "country": null,
          "logical_id": 19,
          "place": null,
          "region": null,
          "zip_code": null
        },
        {
          "city": "Baghdad",
          "country": null,
          "logical_id": 20,
          "place": null,
          "region": null,
          "zip_code": null
        }
      ],
      "designation_details": null,
      "entity_type": "person",
      "eu_reference_number": "EU.39.56",
      "identifiers": [],
      "legal_basis": [
        {
          "entry_into_force_date": "2003-07-07",
          "number_title": "1210/2003 (OJ L169)",
          "organisation_type": "commission",
          "programme": "IRQ",
          "publication_date": "2003-07-08",
          "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
          "regulation_type": "regulation"
        }
      ],
      "listed_on": "2003-07-08",
      "listed_on_source": "earliest_regulation_summary",
      "logical_id": 20,
      "measures": [
        "asset_freeze"
      ],
      "names": [
        {
          "first_name": "Qusay",
          "function": "Oversaw Special Republican Guard, Special Security Organisation, and Republican Guard",
          "gender": "M",
          "language": null,
          "last_name": "Hussein Al-Tikriti",
          "logical_id": 26,
          "middle_name": "Saddam",
          "name": "Qusay Saddam Hussein Al-Tikriti",
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "regulation_language": "en",
          "remarks": [],
          "strong": true,
          "title": null,
          "type": "primary"
        },
        {
          "first_name": "Qoussaï",
          "function": null,
          "gender": null,
          "language": "FR",
          "last_name": "Hussein Al-Tikriti",
          "logical_id": 381,
          "middle_name": "Saddam",
          "name": "Qoussaï Saddam Hussein Al-Tikriti",
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "regulation_language": "en",
          "remarks": [],
          "strong": true,
          "title": null,
          "type": "alias"
        }
      ],
      "nationalities": [
        {
          "country": {
            "iso2": "IQ",
            "name": "IRAQ"
          },
          "logical_id": 2,
          "region": null,
          "regulation": {
            "number_title": "1210/2003 (OJ L169)",
            "publication_date": "2003-07-08",
            "publication_url": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2003:169:0006:0023:EN:PDF",
            "regulation_type": "regulation"
          },
          "remarks": []
        }
      ],
      "primary_name": "Qusay Saddam Hussein Al-Tikriti",
      "programs": [
        "IRQ"
      ],
      "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
      "remarks": [
        "Saddam's second son"
      ],
      "retrieved_at": "2026-10-17T23:18:35Z",
      "source_record_id": "eu:20",
      "source_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
      "subject_type": {
        "classification_code": "P",
        "code": "person"
      },
      "un_reference": null
    }
  ],
  "retrieved_at": "2026-10-17T23:18:35Z",
  "source_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
  "total": 6234
}
```

### Search

- Capability: `sanctions/search`
- Description: Name search over the current consolidated list: every whitespace-separated term of `q` must occur (case-insensitive substring) in one of an entity's names, in any language or script (nameAlias wholeName). Optional programme and entity_type filters. Returns compact hits in file order (source_record_id, EU reference number, entity type, primary name, the names that matched, programmes, listing date, UN reference); records_get has the full record. `total` counts every matching entity; when it exceeds `limit` the result is marked partial. An empty result is a legitimate answer (no name contains the terms), not an error. A match or an absence is not a compliance determination.
- Instructions: Find whether a name (or part of one, in any script) appears on the EU financial sanctions list and get the identifiers to fetch the full records.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/sanctions/search)

Accepted options:
- `entity_type` (string): entity_type Example: `person`
- `limit` (number): Maximum hits returned (default 25). Example: `25`
- `programme` (string): Restrict to one programme code (UKR, IRN, ...). Example: `<programme>`
- `q` (string, required): Name or name fragment; terms are matched as substrings, all must match the same name. Example: `<q>`

Response schema example:
```json
{
  "count": 1,
  "filter": {
    "entity_type": null,
    "programme": null
  },
  "observed_at_ms": 1792279145308,
  "publication": {
    "content_hash": {
      "algorithm": "sha1",
      "value": "0BA673508859A90863F5BDBEDD14F36A23A6F65C"
    },
    "file_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
    "generation_date": "2026-10-15T12:10:34.160+02:00",
    "global_file_id": "185699",
    "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
    "published_at": "2026-10-15T10:20:12Z",
    "record_count": 6234,
    "size_bytes": 25767041
  },
  "query": "Dorda",
  "results": [
    {
      "entity_type": "person",
      "eu_reference_number": "EU.3886.3",
      "listed_on": "2011-02-26",
      "logical_id": 6106,
      "matched_names": [
        "Abu Zayd Umar DORDA",
        "Dorda Abuzed OE",
        "Abu  Zayd Umar Hmeid Dorda"
      ],
      "primary_name": "Abu Zayd Umar DORDA",
      "programs": [
        "LBY"
      ],
      "source_record_id": "eu:6106",
      "un_reference": "LYi.006"
    }
  ],
  "retrieved_at": "2026-10-17T23:19:04Z",
  "source_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
  "total": 1,
  "truncated": false
}
```

### Source status

- Capability: `sanctions/source_status`
- Description: Cheap version check from the RSS feed (one 4 KB request, no file download): the current XML 1.1 publication's id (the publisher's SHA-1 checksum of the file, from the feed's guid), publication date, file resource URL (without the public access query parameter the feed prints; see file_url), size in bytes and content hash, plus the same for every published file (PDF 1.0, CSV 1.0, CSV 1.1, XML 1.1, XML 1.0). The record count is not returned here because it needs the 25 MB file; records_list returns it. Use the publication_id to decide whether a held snapshot is stale.
- Instructions: Is there a newer consolidated list than the one I hold? Which file URLs, sizes and checksums are published right now?
- Cost: 5 credits per call
- Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/webgate-ec-europa-eu/sanctions/source_status)

Accepted options:

Response schema example:
```json
{
  "content_hash": {
    "algorithm": "sha1",
    "value": "0BA673508859A90863F5BDBEDD14F36A23A6F65C"
  },
  "file_id": "xmlFullSanctionsList_1_1",
  "file_url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
  "files": [
    {
      "content_type": "application/pdf",
      "file_id": "pdfFullSanctionsList",
      "format": "pdf",
      "published_at": "2026-10-15T10:20:09Z",
      "sha1": "8911553442327710C04651CA71F2ABD5EF141633",
      "size_bytes": 18422925,
      "title": "PDF - v1.0",
      "url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/pdfFullSanctionsList/content",
      "version": "1.0"
    },
    {
      "content_type": "text/plain",
      "file_id": "csvFullSanctionsList",
      "format": "csv",
      "published_at": "2026-10-15T10:20:17Z",
      "sha1": "99D28804EDA545C983C32C0F28E289DE8C3A2A26",
      "size_bytes": 18912812,
      "title": "CSV - v1.0",
      "url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/csvFullSanctionsList/content",
      "version": "1.0"
    },
    {
      "content_type": "text/plain",
      "file_id": "csvFullSanctionsList_1_1",
      "format": "csv",
      "published_at": "2026-10-15T10:20:14Z",
      "sha1": "F398403BF5716613CEC858870A31362BADB4F048",
      "size_bytes": 25166754,
      "title": "CSV - v1.1",
      "url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/csvFullSanctionsList_1_1/content",
      "version": "1.1"
    },
    {
      "content_type": "application/xml",
      "file_id": "xmlFullSanctionsList_1_1",
      "format": "xml",
      "published_at": "2026-10-15T10:20:12Z",
      "sha1": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
      "size_bytes": 25767041,
      "title": "XML (Based on XSD) - v1.1",
      "url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList_1_1/content",
      "version": "1.1"
    },
    {
      "content_type": "application/xml",
      "file_id": "xmlFullSanctionsList",
      "format": "xml",
      "published_at": "2026-10-15T10:20:11Z",
      "sha1": "30F1DFFC1DE5881DBA02221A3E05AFF76F01A3E2",
      "size_bytes": 25572310,
      "title": "XML (Based on XSD) - v1.0",
      "url": "https://webgate.ec.europa.eu/fsd/fsf/public/files/xmlFullSanctionsList/content",
      "version": "1.0"
    }
  ],
  "observed_at_ms": 1792279102839,
  "publication_id": "0BA673508859A90863F5BDBEDD14F36A23A6F65C",
  "published_at": "2026-10-15T10:20:12Z",
  "retrieved_at": "2026-10-17T23:18:22Z",
  "size_bytes": 25767041,
  "source_url": "https://webgate.ec.europa.eu/fsd/fsf/public/rss"
}
```
