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.
Training environment
XSD schema
The XSD schema against which the XML report should be validated can be downloaded here.
The current version is: xsd goAML 2026-06-29 (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-06-29 (234 Kb) |
- Added report indicators - report_indicator_type
|
xsd goAML 2026-05-22 (225 Kb) |
- Added currency code CNH – currency_type
|
xsd goAML 2026-01-05 (Text, 225 Kb) |
- Addition of 76 new indicators – report_indicator_type
|
xsd goAML 2025-06-10 (Text, 217 Kb) |
New relationships – currently only to be used for virtual IBANs:
- Account → linked account(s) – related_accounts
Role: Virtual IBAN master account (VIMA)
- Account → other linked entities – related_entities
Role: Payment Service Provider (PSP)
New account type – account_type:
- Virtual IBAN master account [VIMA]
New role for entity ↔ person relationships – entity_person_role_type:
|
xsd goAML 2024-07-31 (Text, 217 Kb) |
- Increased character limit for comments_type fields to 200,000
This includes notably:
- Motivation (summary) and urgent request(s) to the FIU
- Various Description and Comments fields under transactions, entities and persons, etc.
|
xsd goAML 2024-02-22 (Text, 216 Kb) |
- Added social_media for persons
|
xsd goAML 2024-01-26 (Text, 217 Kb) |
see goAML 5.2 |
xsd goAML 2023-03-03 (Text, 169 Kb) |
- 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
- Société par actions simplifiée (SAS)
- Société en commandite spéciale (SCSp)
- Trust
- Fiducie
- In production since 3 March 2023
|
goAMLSchema 5_0 final (Text, 168 Kb) |
- Version of the schema with asserts and min/max restrictions
- Currently active in the Training environment
For details, see goAML 5.0 |
goAMLSchema_5_0_light (Text, 150 Kb) |
- 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 |
xsd goaml 2020-09-10 (Text, 116 Kb) |
- Removal of 4 obsolete indicators:
- “–”: Other
- “1”: Suspicious cash deposits
- “10”: Cash transactions
- “19”: Smurfing
|
xsd goaml 2020-05-13 (Text, 114 Kb) |
- 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)
|
xsd goaml 2020-01-10 (Text, 113 Kb) |
- New report type 74‑4 for stakeholders (to be ignored by the other types of reporting entities)
- Added currency SSP
|
xsd goaml 2018-05-03 (Text, 116 Kb) |
- 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
|
xsd goaml 2017-02-15 (Text, 116 Kb) |
- 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
|
xsd-goaml-2016-12-01 (Text, 98 Kb) |
- Added currency JPY
- Email format validation simplified
- Added account type Prepaid credit card
|
xsd-goaml-2016-10-18 (Text, 102 Kb) |
- 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
|
xsd goAML 2016-06-29 (Text, 102 Kb) |
- 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
|
xsd goAML 2016-05-12 (Text, 123 Kb) |
- New report_type values
- New dedicated report types for terrorist financing
- Party role type now accepts value “–” only
- Additional element annotations included
|
xsd_goAML_2016-04-20 (Text, 151 Kb) |
- Added role F – Contact person in account‑person relationships
- Added account status code E – Blocked
|
xsd_goAML_2016-03-21 (Text, 151 Kb) |
|
|
|
| |
External documentation
Additional explanations about goAML can be found on the UNODC website:
https://goaml.unodc.org/goaml/index.html
