Launch Announcement: Additional Dangerous Goods UN numbers supported via Shipping V2 APIs
Starting 12 November 2026, Amazon Shipping now supports 11 additional Dangerous Goods (DG) UNID numbers in the US, UK, FR, IT and ES marketplaces. The launch was completed in all five marketplaces. The new UN numbers are for ground shipments only.
What is improving?
Amazon Shipping now supports up to 36 DG UN numbers, up from 25. Not every new UN number is available in every marketplace. Check the Dangerous Goods Shipping Guide for your marketplace.
| Class | UN number | Examples |
|---|---|---|
| 2.1 Flammable gases | UN3358 | Refrigerating machines containing flammable gas (not available in the US) |
| 3 Flammable liquids | UN1263 | Paint-related material in small items, such as nail varnish or small lacquer tins (per-item limits apply) |
| 3 Flammable liquids | UN1219 | Isopropanol (isopropyl alcohol) (not available in the US) |
| 3 Flammable liquids | UN1133 | Adhesives |
| 3 Flammable liquids | UN1987 | Alcohols n.o.s., such as alcohol wipes (not drinks or spirits) |
| 4.1 Flammable solids | UN3175 | Solids containing flammable liquid |
| 8 Corrosives | UN2800 | Non-spillable wet batteries |
| 9 Miscellaneous | UN2807 | Magnetized material |
| 9 Miscellaneous | UN3316 | Chemical kits and first aid kits |
| 9 Lithium batteries | UN3480 | Standalone lithium-ion batteries (selected marketplaces) |
| 9 Lithium batteries | UN3090 | Standalone lithium metal batteries (selected marketplaces) |
You declare the new UN numbers in the same DG attributes you already send to the Shipping V2 APIs. The API request and response schemas have not changed.
Some UN numbers are not available on every service. If no service can carry the item to the destination, no rate is returned.
Which marketplaces are affected?
| Marketplace | x-amzn-shipping-business-id |
|---|---|
| United States | AmazonShipping_US |
| United Kingdom | AmazonShipping_UK |
| France | AmazonShipping_FR |
| Italy | AmazonShipping_IT |
| Spain | AmazonShipping_ES |
Who is affected?
Shippers and integrators who are already enabled for Dangerous Goods and create shipments with getRates, purchaseShipment or oneClickShipment. You are not affected if you do not ship Dangerous Goods.
What action is required?
No schema changes are required. However, if you ship in the UK, ensure every item sent with isHazmat: true includes the full DG attributes listed below — requests with missing attributes are rejected from 03 Nov 2026. To ship one of the new UN numbers
- Check that the UN number is listed in the Dangerous Goods Shipping Guide for your marketplace, and check its limits.
- Add the UN number to your DG declaration in Shipper Central → Settings → Operations → Dangerous Goods → Declare Dangerous Goods. If you send a UN number that you have not declared, the request is rejected.
- Send the UN number and its DG attributes at item level in your getRates or oneClickShipment request (see the sample below).
UK attribute rule (effective 03 Nov 2026): in the UK, any item sent with isHazmat: true must include the full DG attributes for that item. If attributes are missing, the request is rejected. Items without DG should be sent with isHazmat: false.
Technical Implementation Details
No new fields. The new UN numbers use the existing Item.isHazmat, Item.dangerousGoodsDetails and Item.liquidVolume fields.
Required attributes by UN number
Every DG item needs isHazmat: true, unitedNationsRegulatoryId and transportationRegulatoryClass. The other attributes depend on the UN number:
| UN number(s) | packingGroup | liquidVolume (item level) | packingInstruction |
|---|---|---|---|
| UN3358 (Class 2.1) | — | — | — |
| UN1263, UN1219, UN1133, UN1987 (Class 3) | Required | Required | — |
| UN3175 (Class 4.1) | Required (II or III) | — | — |
| UN2800 (Class 8) | — | — | — |
| UN2807 (Class 9) | — | — | — |
| UN3316 (Class 9) | Required (II or III) | — | — |
| UN3480 (Class 9) | — | — | Required: PI965_SECTION_II |
| UN3090 (Class 9) | — | — | Required: PI968_SECTION_II |
Limits (volume per item, or package weight for UN3175 and UN3316) differ by UN number and marketplace. See the Dangerous Goods Shipping Guide for your marketplace.
Sample getRates request (POST /shipping/v2/shipments/rates): UK, adhesive, UN1133
POST /shipping/v2/shipments/rates): UK, adhesive, UN1133{
"shipTo": {
"name": "Test Recipient",
"addressLine1": "Test XX Way",
"city": "Leeds",
"postalCode": "XX XXX",
"countryCode": "GB",
"email": "[email protected]",
"phoneNumber": "XXXX"
},
"shipFrom": {
"name": "Example Warehouse",
"addressLine1": "XXX XX Road",
"city": "Feltham",
"postalCode": "XX XXX",
"countryCode": "GB",
"email": "[email protected]",
"phoneNumber": "XXXX"
},
"packages": [
{
"dimensions": { "length": 15, "width": 10, "height": 8, "unit": "CENTIMETER" },
"weight": { "value": 0.3, "unit": "KILOGRAM" },
"insuredValue": { "value": 8.99, "unit": "GBP" },
"packageClientReferenceId": "ORD-100245",
"items": [
{
"description": "Contact adhesive 125 ml",
"quantity": 1,
"weight": { "value": 0.2, "unit": "KILOGRAM" },
"itemValue": { "value": 8.99, "unit": "GBP" },
"isHazmat": true,
"liquidVolume": { "value": 125, "unit": "ML" },
"dangerousGoodsDetails": {
"unitedNationsRegulatoryId": "UN1133",
"transportationRegulatoryClass": "3",
"packingGroup": "III"
}
}
]
}
],
"channelDetails": { "channelType": "EXTERNAL" }
}
Sample response
The response format has not changed. You receive the same getRates response as for any other DG shipment.
{
"payload": {
"requestToken": "amzn1.rq.123456789012345.101",
"rates": [
{
"rateId": "a1b2c3d4e5f6...",
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"serviceId": "SWA-UK-2D",
"serviceName": "Amazon Shipping Two Day",
"totalCharge": { "unit": "GBP", "value": 3.72 },
"requiresAdditionalInputs": false
}
],
"ineligibleRates": []
}
}
Error Handling
These are the existing Dangerous Goods validation errors (see the Error Code Enhancement Phase 2 announcement). They also apply to the new UN numbers.
| HTTP status | code | When it occurs | How to handle |
|---|---|---|---|
| 400 | MISSING_UNID (D-600) | isHazmat: true without unitedNationsRegulatoryId | Add the UN number |
| 400 | MISSING_HTRC (D-601) | transportationRegulatoryClass missing | Add the class |
| 400 | MISSING_PACKING_GROUP (D-602) | Packing group required for the UN number but not sent | Add packingGroup |
| 400 | MISSING_LIQUID_VOLUME (D-603) | Liquid volume required for the UN number but not sent | Add item-level liquidVolume |
| 400 | IMPERMISSIBLE_UNID (D-604) | UN number is not supported in your marketplace | Check the DG Shipping Guide for your marketplace |
| 400 | IMPERMISSIBLE_CLASS (D-605) | Class is not supported | Check the class against the UN number |
| 400 | IMPERMISSIBLE_PACKING_INSTRUCTION (D-607) | Packing instruction is not supported | Use a supported packingInstruction |
| 400 | ACCOUNT_NOT_ENABLED_FOR_DG (S-404) | Account is not enabled for DG | Complete the DG declaration in Shipper Central |
| 400 | DG_NOT_SUPPORTED_FOR_DESTINATION (S-405) | DG cannot be delivered to the destination postcode | Amazon Shipping cannot deliver DG to this postcode |
Sample error response:
{
"errors": [
{
"code": "MISSING_PACKING_GROUP",
"message": "Packing group is required for the UN number provided.",
"details": "Packing group is required for the UN number provided. (D-602)"
}
]
}
Note
You must comply with all applicable laws and regulations. For the full list of supported UN numbers and their limits, see the Dangerous Goods Shipping Guide for your marketplace: US | UK | FR | IT | ES.
FAQs
1. Do I need to change my integration?
No. The request and response schemas have not changed. Send the new UN number in dangerousGoodsDetails.unitedNationsRegulatoryId with the matching class and attributes.
2. Why was my request with a new UN number rejected?
The most common reason is that the UN number has not been added to your DG declaration in Shipper Central. Add it under Settings → Operations → Dangerous Goods → Declare Dangerous Goods, then retry. The UN number may also not be available in your marketplace.
3. Where do I find the supported UN numbers and their limits?
In the Dangerous Goods Shipping Guide for your marketplace. The UN numbers and limits differ by marketplace.
4. Can I ship by air?
No. The new UN numbers are supported for road shipments only.
5. Does UN1263 mean I can ship paint?
No. Per-item limits still apply (150 mL in the UK; see the UK Prohibited Items guide). Check the limits for your marketplace.
6. Can I ship two different UN numbers in the same package?
No. Each package can contain only one UN number. For example, a standalone battery (UN3480) and a battery in equipment (UN3481) are different UN numbers, so ship them in separate packages.
7. What changed in the UK from 03 November 2026?
Any UK item sent with isHazmat: true must include the full DG attributes for that item, or the request is rejected. Items without DG should be sent with isHazmat: false.
