OpenDGD v1.0 is here — get spec updates and new NCB Hazcheck tools.
OpenDGD by NCB Hazcheck

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": "1.0",
  "documentType": "IMDG_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": "1.0",
  "documentType": "IMDG_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": "1.0",
  "documentType": "IMDG_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"
      }
    }
  }
}