OpenDGD 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": "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"
      }
    }
  }
}