diff --git a/samples/is20022message.json b/samples/is20022message.json
new file mode 100644
index 0000000..3885b4d
--- /dev/null
+++ b/samples/is20022message.json
@@ -0,0 +1,43 @@
+{
+    "activity_report": {
+        "related_message_reference": {
+            "creation_date_time": "2009-09-09T11:37:00",
+            "identification": "ARRMessage24"
+        },
+        "report": [
+            {
+                "transaction_identification": "01190799181-6940-48",
+                "reported_entity": [
+                    {
+                        "bic": "ADIABE22"
+                    }
+                ],
+                "reported_item": [
+                    {
+                        "activity": {
+                            "message_name": "tsmt.011.001.02"
+                        },
+                        "initiator": {
+                            "bic": "SWHQBEBB"
+                        },
+                        "date_time": "2009-09-06T08:54:00"
+                    },
+                    {
+                        "activity": {
+                            "message_name": "tsmt.020.001.02"
+                        },
+                        "initiator": {
+                            "bic": "ADIABE22"
+                        },
+                        "date_time": "2009-09-06T08:52:00"
+                    }
+                ]
+            }
+        ],
+        "report_identification": {
+            "creation_date_time": "2009-09-09T11:38:00",
+            "identification": "ARPMessage25"
+        }
+    },
+    "@xmlns": "urn:iso:std:iso:20022:tech:xsd:tsmt.002.001.04"
+}
\ No newline at end of file
diff --git a/samples/readme.md b/samples/readme.md
new file mode 100644
index 0000000..2f1752e
--- /dev/null
+++ b/samples/readme.md
@@ -0,0 +1,13 @@
+
+## JSON samples
+
+#### [ISO 20022 and JSON: An Implementation Best Practices Whitepaper](https://www.iso20022.org/sites/default/files/documents/general/ISO20022_API_JSON_Whitepaper_Final_20180129.pdf)
+
+By members of the ISO 20022 Registration Management Group and the Technical Support Group
+Approved for publication by the ISO 20022 RMG 29 January, 2018
+
+#### Page  32
+#### Date: January 2018
+---
+
+