Examples
Worked declarations.
Complete OpenDGD documents you can download, validate against the schema, or paste into the playground.
acetone-un1090.jsondownload
A single flammable-liquid line (UN 1090, ACETONE, Class 3).
{
"openDgdVersion": "0.1",
"documentType": "IMO_MULTIMODAL_DANGEROUS_GOODS_FORM",
"documentReference": "DGD-EXAMPLE-0001",
"issueDate": "2026-07-21",
"regulation": {
"code": "IMDG",
"edition": "42-24"
},
"consignment": {
"parties": {
"shipper": {
"name": "Example Shipper Ltd",
"address": "1 Example Way, Felixstowe, IP11 0AA, United Kingdom",
"emergencyContact": {
"name": "Example 24h Response",
"telephone": "+00 0000 000000"
}
},
"consignee": {
"name": "Example Consignee BV",
"address": "Example Kade 1, Rotterdam, Netherlands"
},
"carrier": {
"name": "Example Container Line"
}
},
"references": {
"transportDocumentNumber": "BOL-EXAMPLE-0001",
"shippersReference": "REF-EXAMPLE-0001"
},
"transport": {
"modeOfTransport": "sea",
"shipType": "cargo",
"vessel": "MV EXAMPLE",
"voyageNumber": "V001",
"sailingDate": "2026-07-25",
"portOfLoading": "Felixstowe",
"portOfDischarge": "Rotterdam",
"destination": "Rotterdam"
},
"cargoTransportUnit": {
"unitType": "container",
"identificationNumber": "EXMU 000000-0",
"sealNumbers": "SEAL-0001",
"sizeType": "40' GP",
"tareMassKg": 3800,
"totalGrossMassKg": 6150
},
"dangerousGoods": [
{
"lineReference": "L1",
"unNumber": "1090",
"properShippingName": "ACETONE",
"class": [
"3"
],
"packingGroup": "II",
"marks": "EXAMPLE LOT 44",
"packaging": {
"numberOfPackages": 10,
"kindOfPackages": "Steel drums",
"outerPackagingCode": "1A1"
},
"weights": {
"grossMassKg": 2350,
"netMassKg": 2000
},
"cubeM3": 2.4,
"flashpoint": {
"valueCelsius": -17,
"cup": "closed"
},
"emergencySchedule": {
"fire": "F-E",
"spillage": "S-D"
}
}
],
"certificates": {
"shipperDeclaration": {
"companyName": "Example Shipper Ltd",
"declarantName": "A. Example, Shipping Manager",
"placeAndDate": "Felixstowe, 2026-07-21",
"signature": "A EXAMPLE"
},
"containerPackingCertificate": {
"companyName": "Example Shipper Ltd",
"declarantName": "B. Example, Warehouse Supervisor",
"placeAndDate": "Felixstowe, 2026-07-21",
"signature": "B EXAMPLE"
}
}
}
}
lithium-battery-un3480.jsondownload
A Class 9 lithium battery line exercising the special-provision path.
{
"openDgdVersion": "0.1",
"documentType": "IMO_MULTIMODAL_DANGEROUS_GOODS_FORM",
"documentReference": "DGD-EXAMPLE-0002",
"issueDate": "2026-07-21",
"regulation": {
"code": "IMDG",
"edition": "42-24"
},
"consignment": {
"parties": {
"shipper": {
"name": "Example Cells GmbH",
"address": "Example Strasse 5, Hamburg, Germany"
},
"consignee": {
"name": "Example Assembly Co",
"address": "1 Example Blvd, Charleston, SC, USA"
},
"carrier": {
"name": "Example Ocean Line"
}
},
"references": {
"transportDocumentNumber": "BOL-EXAMPLE-0002"
},
"transport": {
"modeOfTransport": "sea",
"shipType": "cargo",
"vessel": "MV SAMPLE",
"voyageNumber": "S001",
"sailingDate": "2026-08-02",
"portOfLoading": "Hamburg",
"portOfDischarge": "Charleston",
"destination": "Charleston"
},
"cargoTransportUnit": {
"unitType": "container",
"identificationNumber": "EXLU 000000-0",
"sealNumbers": "SEAL-0002",
"sizeType": "20' GP",
"tareMassKg": 2200,
"totalGrossMassKg": 8700
},
"dangerousGoods": [
{
"lineReference": "L1",
"unNumber": "3480",
"properShippingName": "LITHIUM ION BATTERIES",
"class": [
"9"
],
"marks": "EXAMPLE PALLET 01",
"packaging": {
"numberOfPackages": 12,
"kindOfPackages": "Fibreboard boxes",
"outerPackagingCode": "4G"
},
"weights": {
"grossMassKg": 6500,
"netMassKg": 5400
},
"cubeM3": 18.5,
"emergencySchedule": {
"fire": "F-A",
"spillage": "S-I"
},
"specialProvisionNotes": [
"376"
],
"additionalInformation": "State of charge not exceeding 30% of rated capacity."
}
],
"certificates": {
"shipperDeclaration": {
"companyName": "Example Cells GmbH",
"declarantName": "C. Example, DG Safety Adviser",
"placeAndDate": "Hamburg, 2026-07-21",
"signature": "C EXAMPLE"
}
}
}
}
radioactive-un2915.jsondownload
A Class 7 line with radionuclide, activity, category, transport index and a competent-authority approval.
{
"openDgdVersion": "0.1",
"documentType": "IMO_MULTIMODAL_DANGEROUS_GOODS_FORM",
"documentReference": "DGD-EXAMPLE-0003",
"issueDate": "2026-07-21",
"regulation": {
"code": "IMDG",
"edition": "42-24"
},
"consignment": {
"parties": {
"shipper": {
"name": "Example Isotopes Ltd",
"address": "1 Example Park, Example City"
},
"consignee": {
"name": "Example Medical Centre",
"address": "2 Example Road, Example City"
},
"carrier": {
"name": "Example Container Line"
}
},
"references": {
"transportDocumentNumber": "BOL-EXAMPLE-0003"
},
"transport": {
"modeOfTransport": "sea",
"shipType": "cargo",
"vessel": "MV EXAMPLE",
"voyageNumber": "V002",
"sailingDate": "2026-07-28",
"portOfLoading": "Southampton",
"portOfDischarge": "New York",
"destination": "New York"
},
"cargoTransportUnit": {
"unitType": "container",
"identificationNumber": "EXRU 000000-0",
"sealNumbers": "SEAL-0003",
"sizeType": "20' GP",
"tareMassKg": 2100,
"totalGrossMassKg": 2260
},
"dangerousGoods": [
{
"lineReference": "L1",
"unNumber": "2915",
"properShippingName": "RADIOACTIVE MATERIAL, TYPE A PACKAGE",
"class": [
"7"
],
"marks": "EXAMPLE RA 01",
"packaging": {
"numberOfPackages": 2,
"kindOfPackages": "Type A packages"
},
"weights": {
"grossMassKg": 160,
"netMassKg": 40
},
"cubeM3": 0.5,
"emergencySchedule": {
"fire": "F-I",
"spillage": "S-S"
},
"radioactive": {
"radionuclide": "Cobalt-60",
"description": "Sealed source, solid, special form",
"activity": "3.7 GBq",
"category": "II-YELLOW",
"transportIndex": 0.5,
"specialForm": true,
"isFissile": false,
"packageType": "A",
"overpack": false,
"competentAuthorityReferences": [
"GB/1234/S"
]
},
"permits": [
{
"type": "competent-authority",
"value": "GB/1234/AF"
}
]
}
],
"certificates": {
"shipperDeclaration": {
"companyName": "Example Isotopes Ltd",
"declarantName": "D. Example, RPA",
"placeAndDate": "Southampton, 2026-07-21",
"signature": "D EXAMPLE"
}
}
}
}