IT Topics
XML development guide
containing the applicable procedures, examples, points of attention, and tips:
XML developments for STR and SAR (Pdf, 1009 Kb)
For e‑commerce reporting entities, please contact us to receive further information on the specific requirements that apply to you in relation to the above guide.
XSD schema
The XSD schema against which the XML report should be validated can be downloaded here.
The current version is: xsd goAML 2026-09-14.xsd (234 Kb)
The XSD schema required for XML transactions can be downloaded here. This schema allows transactions to be included in a report that was started online.
The current version is: xsd goAML 2026-05-22 Transactions (196 Kb)
For more information regarding this schema: Transaction upload/download
Note: If you are an e‑commerce reporting entity (goAML reporting entity types: E‑Bank, E-Money Institutions, Payment Institutions, Virtual Asset Service Providers (VASPs)), the “transactions” XSD schema cannot be used.
Lookup values
The enumeration values defined by the CRF — including the indicators — can be extracted from the following Excel file:
Structure diagram
A high-level example illustrating the structure of reports with and without transactions:
Diagram of the goAML report structure EN – version du 2022-09-02 pour goAML 5.0 (Pdf, 330 Kb)
Version history
|
Schema |
Changes compared to the previous release |
| xsd-goAML-2026-09-14.xsd (234 Kb) | - Added report indicators - report_indicator_type |
| - Added report indicators - report_indicator_type | |
| - Added currency code CNH – currency_type | |
| - Addition of 76 new indicators – report_indicator_type | |
|
- New relationships – currently only to be used for virtual IBANs: 💠Account → linked account(s) – related_accounts
💠Account → other linked entities – related_entities
- New account type – account_type 💠Virtual IBAN master account [VIMA] - New role for entity ↔ person relationships – entity_person_role_type 💠Shareholder [H] |
|
|
- Increased character limit for comments_type fields to 200,000
💠Motivation (summary) and urgent request(s) to the FIU 💠Various Description and Comments fields under transactions, entities and persons, etc. |
|
| - Added social_media for persons | |
| - see goAML 5.2 | |
|
– Schema with assert restrictions + minOccurs/maxOccurs updates Assert communication March 2022-03-10 (Pdf) minOccurs and maxOccurs attributes (Pdf) Other changes: - Added account types: 💠Mobile phone wallet 💠Virtual IBAN - Added 5 new entity types: 💠Anstalt 💠Simplified public limited liability company (SAS) 💠Special limited partnership (SCSp) 💠Trust 💠Fiducie In production since 3 March 2023 |
|
|
- Version of the schema with asserts and min/max restrictions - Currently active in the Training environment For details, see goAML 5.0 |
|
|
- Transition to goAML 5.0 using the “light” XSD version (new features activated without restrictions) 💠Hybrid reports (transaction + activity) 💠Entity‑entity relationships with roles 💠Added currency codes XAG, XPT, XPD 💠Schema elements are no longer nillable Active in production from 2 September 2022 to 2 March 2023 |
|
|
- Removal of 4 obsolete indicators: 💠“–”: Other 💠“1”: Suspicious cash deposits 💠“10”: Cash transactions 💠“19”: Smurfing |
|
| - New report type 74‑6 for stakeholders (ignored by other reporters)
- Added legal form: Non-profit organisation (NPO) - New funds_type: Insurance subscription - Review of indicator list (some marked obsolete; permanent removal after 3 months) → Full before/after comparison in 2020-05-13_indicators_comparison (EXCEL) |
|
| - New report type 74‑4 for stakeholders (to be ignored by the other types of reporting entities)
- Added currency SSP |
|
| - New indicator type 31 – Reluctance to provide supporting documents
- Added country codes KS and XK - Maximum length of SWIFT/BIC field increased from 8 to 11 characters |
|
| - New report types for national authorities
- New account type Insurance contract - Added currencies BYN and PKR - Added “beneficial owner” and “other” in entity–person relationship roles |
|
| - Added currency JPY
- Email format validation simplified - Added account type Prepaid credit card |
|
| - Removed obsolete ISO country codes
- New account status value: D – FIU block - Added indicator 30 – Professional obligations - Removed duplicate code in account-person-role type - Removed unused declaration type IORI |
|
| - Three fields removed for persons: title, prefix, mother’s name (maxOccurs = 0)
- Indicators added to enumeration values - Added funds type S – Money remittance - Transactions may now have status K – Authorised - Email REGEX updated for universal compatibility |
|
| - New report_type values
- New dedicated report types for terrorist financing - Party role type now accepts value “–” only - Additional element annotations included |
|
| - Added role F – Contact person in account‑person relationships
- Added account status code E – Blocked |
|
| - First published version |
External documentation
Additional explanations about goAML can be found on the UNODC website:
Last update