Skip to main content
Glama
FreightUtils MCP Server

FreightUtils MCP Server

adr_exemption_calculator

Read-onlyIdempotent

Calculates ADR 1.1.3.6 small-load exemption points and checks whether packaged dangerous goods qualify, including mixed loads and category limits.

Instructions

ADR 1.1.3.6 "small load" exemption points for a dangerous-goods road load, and whether it qualifies; points = quantity x the transport category multiplier. The rule (1.1.3.6.2), for dangerous goods carried in packages: goods of ONE transport category qualify when their TOTAL on the transport unit stays within that category's 1.1.3.6.3 column (3) maximum (category 1: 20, 2: 333, 3: 1,000 kg or L; 4 unlimited; 0: 0); goods of DIFFERENT categories qualify when the 1.1.3.6.4 points sum does not exceed 1,000. Transport category 0 can never use the exemption. For limited/excepted quantity relief use adr_lq_eq_check; for a substance's row and variant_index adr_lookup; for the whole ADR picture of a load (tunnels, documents, plates) adr_consignment_check.

Send un_number + quantity for one substance OR items[] for a load — never both: a single-substance field sent beside items[] is refused, never dropped. Quantities are kg or litres per the substance's ADR unit; a quantity of 0 means not carried, and a load of nothing but zeros is refused. A UN number whose Table A rows disagree needs packing_group or variant_index, else that line has no verdict (AMBIGUOUS_UN_VARIANT with candidates[]) — never a guessed row. An ID-prefixed air-only number (e.g. "ID8000") is counted out of 1.1.3.6 only with icao_limited_quantity: true on that line, otherwise BLOCKED. Without that statement the ID line is BLOCKED (items[].entry_required true) and the load has no verdict unless the other lines settle it. A gross mass (basis "gross") is only an upper bound: send the net quantity. edition ("2025" | "2027") and as_of choose the ADR edition; neither sent, ADR 2025 until 2027-01-01. Such an answer headlines the transitional basis that clears the load, names it, gives basis_until (the last day it may be applied) and puts the strict ADR 2027 figure beside it (strict_adr_2027: basis, total_points, exempt, has_category_zero, has_quantity_exceedance). Fields are checked by name: a field the tool does not read is refused with a tool error naming it and listing the accepted ones, never ignored. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. A calculation over reference data, not legal advice: 1.1.3.6 relieves goods carried in packages only (not in bulk or in tanks), and exempt loads keep core duties; verify against the current UNECE ADR text.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "adr_exemption_calculator"
  }
}

Input Schema

NameRequiredDescriptionDefault
unitNoThe dimension quantity is stated in, checked against the one ADR 1.1.3.6.3 counts for the row (a mismatch gives no points). Omitted: taken as already on that basis. Single-substance form only.
as_ofNoThe date the answer is for, YYYY-MM-DD (default today, UTC).
basisNonet or gross; a gross mass is only an upper bound of the net (send the net quantity). Single-substance form only.
itemsNoMixed-load items, INSTEAD of un_number/quantity.
editionNoADR edition; wins over as_of. Omitted: as_of picks it.
quantityNoQuantity in kg or litres per the substance's ADR unit. Single-substance form only.
un_numberNoUN number (4 digits, optionally "UN"-prefixed) or an ID-prefixed air-only number ("ID8000"). Single-substance form only.
consignmentNoThe consignment object, instead of the other arguments. Send it alone.
packing_groupNoPacking group, to pin one row of a multi-row UN. Single-substance form only.
variant_indexNoADR Table A variant index (from adr_lookup), to pin one row. Single-substance form only.
icao_limited_quantityNoID-prefixed un_number only: true states the packages are ICAO Technical Instructions limited quantities (the 3.4.8 mark, or 3.4.10).

Output Schema

NameRequiredDescriptionDefault
okYes
_metaNo
as_ofNo
resultYes
statusNo
_sourceYes
editionNo
citationYes
validityNo
warningsNo
confidenceYes
missing_inputsNo
blocking_errorsNo
envelope_versionYes
normalized_inputNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed21 schema fields changedv2.34.4
    • changedInput schema / properties / as_of / description
      Previous value: -"YYYY-MM-DD the answer is for (default today, UTC); picks the ADR edition when edition is omitted, and is echoed in the answer and its check receipt."New value: +"The date the answer is for, YYYY-MM-DD (default today, UTC)."
    • changedInput schema / properties / basis / description
      Previous value: -"OPTIONAL. 'net' or 'gross'. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging. A 'gross' mass on an entry counted by mass is used only as an upper bound of the net mass: the load is answered exempt on it only when it clears even on the gross figure (figure_basis upper_bound_gross); otherwise, and always for an entry counted in litres, no points — send the net quantity. Single-substance form only — sent beside items[] it is refused; set it on each item."New value: +"net or gross; a gross mass is only an upper bound of the net (send the net quantity). Single-substance form only."
    • changedInput schema / properties / consignment / description
      Previous value: -"Alternative to the other arguments: the consignment object (https://www.freightutils.com/schema/consignment-object.v1.json) — lines[], journey, vehicle, options. Send it alone; an input this tool needs and the object lacks comes back in missing_inputs."New value: +"The consignment object, instead of the other arguments. Send it alone."
    • changedInput schema / properties / edition / description
      Previous value: -"ADR edition: \"2025\" or \"2027\". Wins over as_of. Omit it and as_of picks the edition by the legal timeline: before 2027-01-01 ADR 2025; from 2027-01-01 ADR 2027 (ADR 2025 may still be applied until 2027-06-30 under 1.6.1.1 — edition \"2025\" answers on it until then); from 2027-07-01 ADR 2027 only. An ADR 2027 answer for a date before 2027-01-01 carries an EDITION_NOT_YET_APPLICABLE warning."New value: +"ADR edition; wins over as_of. Omitted: as_of picks it."
    • changedInput schema / properties / icao_limited_quantity / description
      Previous value: -"OPTIONAL, only with an ID-prefixed un_number (e.g. ID8000): true states that the packages are limited quantities conforming to the ICAO Technical Instructions (the 3.4.8 mark, or 3.4.10). Only then is the line counted out of 1.1.3.6; without it the ID line is BLOCKED and the load has no verdict unless the other lines settle it."New value: +"ID-prefixed un_number only: true states the packages are ICAO Technical Instructions limited quantities (the 3.4.8 mark, or 3.4.10)."
    • changedInput schema / properties / items / description
      Previous value: -"Mixed-load items (use INSTEAD of un_number/quantity)."New value: +"Mixed-load items, INSTEAD of un_number/quantity."
    • changedInput schema / properties / items / items / properties / basis / description
      Previous value: -"OPTIONAL. As the top-level basis: a 'gross' mass is used only as an upper bound on an entry counted by mass, and only when the load clears on it."New value: +"net or gross; a gross mass is only an upper bound of the net."
    • changedInput schema / properties / items / items / properties / quantity / description
      Previous value: -"Quantity in kg or litres per the substance's ADR unit. 0 means not carried: the line is left out of the load (EXCLUDED_NIL) and named in a warning; a load of nothing but zeros is refused."New value: +"Quantity in kg or litres per the substance's ADR unit; 0 = not carried."
    • changedInput schema / properties / items / items / properties / un_number / description
      Previous value: -"UN number — 4 digits, optionally \"UN\"-prefixed — or an ID-prefixed air-only number such as \"ID8000\" (AIR_ONLY_ID with icao_limited_quantity: true on the item, else BLOCKED). Example: \"1263\"."New value: +"UN number (4 digits, optionally \"UN\"-prefixed) or an ID-prefixed air-only number (\"ID8000\")."
    • changedInput schema / properties / items / items / properties / unit / description
      Previous value: -"OPTIONAL. The dimension `quantity` is stated in. Omit it and the number is taken as already on the ADR 1.1.3.6.3 basis (unchanged behaviour). Supply it and it is CHECKED against the dimension 1.1.3.6.3 counts for that Table A row — litres for liquids and for compressed or adsorbed gases, kilograms for solids, liquefied/refrigerated/dissolved gases and articles. A mismatch returns total_points null, exempt null and items[].basis_mismatch true, naming the dimension the entry is counted in."New value: +"The dimension quantity is stated in, checked against the one ADR 1.1.3.6.3 counts for the row (a mismatch gives no points). Omitted: taken as already on that basis."
    • changedInput schema / properties / packing_group / description
      Previous value: -"Packing group (I, II or III) — only needed to disambiguate a UN with more than one ADR Table A row (e.g. UN 1789). Ignored for single-row UNs. Single-substance form only — sent beside items[] it is refused; set it on each item."New value: +"Packing group, to pin one row of a multi-row UN. Single-substance form only."
    • changedInput schema / properties / quantity / description
      Previous value: -"Quantity for the single-substance check, in kg or litres per the substance's ADR unit. Single-substance form only — sent beside items[] it is refused. Example: 100."New value: +"Quantity in kg or litres per the substance's ADR unit. Single-substance form only."
    • changedInput schema / properties / un_number / description
      Previous value: -"UN number for a single-substance check — 4 digits, optionally \"UN\"-prefixed — or an ID-prefixed air-only number such as \"ID8000\", which has no ADR Table A entry: counted out of 1.1.3.6 (AIR_ONLY_ID) only with icao_limited_quantity: true; without it the line is BLOCKED. Single-substance form only — sent beside items[] it is refused; send the substance as an item. Example: \"1203\"."New value: +"UN number (4 digits, optionally \"UN\"-prefixed) or an ID-prefixed air-only number (\"ID8000\"). Single-substance form only."
    • changedInput schema / properties / unit / description
      Previous value: -"OPTIONAL. The dimension `quantity` is stated in. Omit it and the number is taken as already on the ADR 1.1.3.6.3 basis (unchanged behaviour). Supply it and it is CHECKED against the dimension 1.1.3.6.3 counts for that Table A row — litres for liquids and for compressed or adsorbed gases, kilograms for solids, liquefied/refrigerated/dissolved gases and articles. A mismatch returns total_points null, exempt null and items[].basis_mismatch true, naming the dimension the entry is counted in. Single-substance form only — sent beside items[] it is refused; set it on each item."New value: +"The dimension quantity is stated in, checked against the one ADR 1.1.3.6.3 counts for the row (a mismatch gives no points). Omitted: taken as already on that basis. Single-substance form only."
    • changedInput schema / properties / variant_index / description
      Previous value: -"ADR Table A variant index (as returned by adr_lookup) — pins one row when a UN has several variants that share a packing group (concentration bands). Ignored for single-row UNs. Single-substance form only — sent beside items[] it is refused; set it on each item."New value: +"ADR Table A variant index (from adr_lookup), to pin one row. Single-substance form only."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / kind / description
      Removed value: -"watched (its upstream is fetched daily) or checksum-only (no upstream of its own)."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / last_success / description
      Removed value: -"The last day (YYYY-MM-DD) the upstream check succeeded; null when none is recorded."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / reason / description
      Removed value: -"Why the state is unknown."
    • removedOutput schema / properties / _meta / properties / upstream / properties / stale / description
      Removed value: -"True only when a dataset below missed its upstream check window (window_missed)."
    • removedOutput schema / properties / _meta / properties / upstream / properties / state / description
      Removed value: -"The worst state of the datasets below."
    • removedOutput schema / properties / _meta / properties / upstream / properties / state_read_at / description
      Removed value: -"When the site upstream check recorded the state (ISO 8601); null when it could not be read."
  2. Changed2 schema fields changedv2.34.0
    • addedOutput schema / properties / _meta / properties / ids
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "pattern": {
      +      "type": "string"
      +    },
      +    "scheme": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "scheme",
      +    "pattern"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / _meta / properties / upstream
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "datasets": {
      +      "additionalProperties": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "kind": {
      +            "description": "watched (its upstream is fetched daily) or checksum-only (no upstream of its own).",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "last_success": {
      +            "description": "The last day (YYYY-MM-DD) the upstream check succeeded; null when none is recorded.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "reason": {
      +            "description": "Why the state is unknown.",
      +            "type": "string"
      +          },
      +          "stale": {
      +            "type": "boolean"
      +          },
      +          "state": {
      +            "enum": [
      +              "in_step",
      +              "changed_upstream",
      +              "schema_drift",
      +              "unreachable",
      +              "window_missed",
      +              "unknown"
      +            ],
      +            "type": "string"
      +          },
      +          "window_days": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "state",
      +          "kind",
      +          "last_success",
      +          "window_days",
      +          "stale"
      +        ],
      +        "type": "object"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "stale": {
      +      "description": "True only when a dataset below missed its upstream check window (window_missed).",
      +      "type": "boolean"
      +    },
      +    "state": {
      +      "description": "The worst state of the datasets below.",
      +      "enum": [
      +        "in_step",
      +        "changed_upstream",
      +        "schema_drift",
      +        "unreachable",
      +        "window_missed",
      +        "unknown"
      +      ],
      +      "type": "string"
      +    },
      +    "state_read_at": {
      +      "description": "When the site upstream check recorded the state (ISO 8601); null when it could not be read.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "state",
      +    "stale",
      +    "state_read_at",
      +    "datasets"
      +  ],
      +  "type": "object"
      +}
  3. Changed12 schema fields changedv2.31.0
    • changedInput schema / properties / basis / description
      Previous value: -"OPTIONAL. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging, so a quantity declared 'gross' returns no points in ANY unit — send the net figure instead. Single-substance form only — sent beside items[] it is refused; set it on each item."New value: +"OPTIONAL. 'net' or 'gross'. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging. A 'gross' mass on an entry counted by mass is used only as an upper bound of the net mass: the load is answered exempt on it only when it clears even on the gross figure (figure_basis upper_bound_gross); otherwise, and always for an entry counted in litres, no points — send the net quantity. Single-substance form only — sent beside items[] it is refused; set it on each item."
    • addedInput schema / properties / icao_limited_quantity
      Added value: +{
      +  "description": "OPTIONAL, only with an ID-prefixed un_number (e.g. ID8000): true states that the packages are limited quantities conforming to the ICAO Technical Instructions (the 3.4.8 mark, or 3.4.10). Only then is the line counted out of 1.1.3.6; without it the ID line is BLOCKED and the load has no verdict unless the other lines settle it.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / items / items / properties / basis / description
      Previous value: -"OPTIONAL. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging, so a quantity declared 'gross' returns no points in ANY unit — send the net figure instead."New value: +"OPTIONAL. As the top-level basis: a 'gross' mass is used only as an upper bound on an entry counted by mass, and only when the load clears on it."
    • addedInput schema / properties / items / items / properties / icao_limited_quantity
      Added value: +{
      +  "description": "OPTIONAL, ID-prefixed lines only: as the top-level icao_limited_quantity.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / items / items / properties / quantity / description
      Previous value: -"Quantity in kg or litres per the substance's ADR unit."New value: +"Quantity in kg or litres per the substance's ADR unit. 0 means not carried: the line is left out of the load (EXCLUDED_NIL) and named in a warning; a load of nothing but zeros is refused."
    • removedInput schema / properties / items / items / properties / quantity / exclusiveMinimum
      Removed value: -0
    • addedInput schema / properties / items / items / properties / quantity / minimum
      Added value: +0
    • changedInput schema / properties / items / items / properties / un_number / description
      Previous value: -"UN number — 4 digits, optionally \"UN\"-prefixed — or an ID-prefixed air-only number such as \"ID8000\" (routed AIR_ONLY_ID; the warning on that line states the limited-quantity condition the 0 rests on). Example: \"1263\"."New value: +"UN number — 4 digits, optionally \"UN\"-prefixed — or an ID-prefixed air-only number such as \"ID8000\" (AIR_ONLY_ID with icao_limited_quantity: true on the item, else BLOCKED). Example: \"1263\"."
    • changedInput schema / properties / un_number / description
      Previous value: -"UN number for a single-substance check — 4 digits, optionally \"UN\"-prefixed — or an ID-prefixed air-only number such as \"ID8000\" (routed AIR_ONLY_ID, nothing counted — the warning on that line states the limited-quantity condition). Single-substance form only — sent beside items[] it is refused; send the substance as an item. Example: \"1203\"."New value: +"UN number for a single-substance check — 4 digits, optionally \"UN\"-prefixed — or an ID-prefixed air-only number such as \"ID8000\", which has no ADR Table A entry: counted out of 1.1.3.6 (AIR_ONLY_ID) only with icao_limited_quantity: true; without it the line is BLOCKED. Single-substance form only — sent beside items[] it is refused; send the substance as an item. Example: \"1203\"."
    • removedOutput schema / properties / _meta / properties / receipt / properties / reason / const
      Removed value: -"key_required"
    • addedOutput schema / properties / _meta / properties / receipt / properties / reason / enum
      Added value: +[
      +  "key_required",
      +  "quota"
      +]
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "candidates": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "item_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "carriage_prohibited": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "conditions": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "heading": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "note": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "requirement": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "conditions_ref": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "exempt": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_category_zero": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_quantity_exceedance": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "human_review_required": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "items": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "air_only_id": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "carriage_prohibited": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "class": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "conditions_ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "not_subject_to_adr": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "points": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "quantity": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "state": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "COUNTED",
      -                        "AIR_ONLY_ID",
      -                        "NOT_SUBJECT_TO_ADR",
      -                        "BLOCKED"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "message": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "not_subject_to_adr": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "resolved_subtotal_points": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "threshold": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "threshold_exceeded_by_resolved_items": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "total_points": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "unresolved_item_indexes": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "type": "number"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "verdict_basis": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "all_items",
      -              "resolved_items_alone",
      -              "none"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "warnings": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "basis": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "adr_2027",
      +              "1.6.1.61",
      +              "1.6.1.1"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "basis_until": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "candidates": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "item_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "carriage_prohibited": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "conditions": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "heading": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "note": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "requirement": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "conditions_ref": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "exempt": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "figure_basis": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "upper_bound_gross"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "has_category_zero": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_quantity_exceedance": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "human_review_required": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "items": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "air_only_id": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "carriage_prohibited": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "class": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "conditions_ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "edition_basis": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "2025",
      +                        "2027"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "entry_required": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "icao_limited_quantity": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "nil_quantity": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "not_subject_to_adr": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "points": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "quantity": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "state": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "COUNTED",
      +                        "AIR_ONLY_ID",
      +                        "NOT_SUBJECT_TO_ADR",
      +                        "BLOCKED",
      +                        "EXCLUDED_NIL"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "upper_bound_gross": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "message": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_subject_to_adr": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "resolved_subtotal_points": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "strict_adr_2027": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "basis": {
      +                "anyOf": [
      +                  {
      +                    "const": "adr_2027",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "deleted_un_numbers": {
      +                "anyOf": [
      +                  {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "entry_deleted": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "exempt": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "has_category_zero": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "has_quantity_exceedance": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "message": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "total_points": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "threshold": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "threshold_exceeded_by_resolved_items": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "total_points": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "transitional_1_6_1_1": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "basis": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "exempt_on_this_basis": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "measure": {
      +                "anyOf": [
      +                  {
      +                    "const": "1.6.1.1",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "note": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "points_on_this_basis": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "until": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "transitional_1_6_1_61": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "basis": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "exempt_on_this_basis": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "max_kg": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "measure": {
      +                "anyOf": [
      +                  {
      +                    "const": "1.6.1.61",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "multiplier": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "note": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "points_on_this_basis": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "un_numbers": {
      +                "anyOf": [
      +                  {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "until": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "unresolved_item_indexes": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "type": "number"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "verdict_basis": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "all_items",
      +              "resolved_items_alone",
      +              "none"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "warnings": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
  4. Changed8 schema fields changedv2.27.0
    • addedInput schema / properties / as_of
      Added value: +{
      +  "description": "YYYY-MM-DD the answer is for (default today, UTC); picks the ADR edition when edition is omitted, and is echoed in the answer and its check receipt.",
      +  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +  "type": "string"
      +}
    • addedInput schema / properties / consignment
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Alternative to the other arguments: the consignment object (https://www.freightutils.com/schema/consignment-object.v1.json) — lines[], journey, vehicle, options. Send it alone; an input this tool needs and the object lacks comes back in missing_inputs.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / edition
      Added value: +{
      +  "description": "ADR edition: \"2025\" or \"2027\". Wins over as_of. Omit it and as_of picks the edition by the legal timeline: before 2027-01-01 ADR 2025; from 2027-01-01 ADR 2027 (ADR 2025 may still be applied until 2027-06-30 under 1.6.1.1 — edition \"2025\" answers on it until then); from 2027-07-01 ADR 2027 only. An ADR 2027 answer for a date before 2027-01-01 carries an EDITION_NOT_YET_APPLICABLE warning.",
      +  "enum": [
      +    "2025",
      +    "2027"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / _meta / properties / check_id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _meta / properties / edition_basis
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _meta / properties / receipt
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "created_at": {
      +      "type": "string"
      +    },
      +    "dataset_version": {
      +      "additionalProperties": {
      +        "type": "string"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "engine_version": {
      +      "type": "string"
      +    },
      +    "inputs": {},
      +    "reason": {
      +      "const": "key_required",
      +      "type": "string"
      +    },
      +    "receipt_hash": {
      +      "type": "string"
      +    },
      +    "result": {
      +      "additionalProperties": {},
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "schema_version": {
      +      "type": "string"
      +    },
      +    "stored": {
      +      "const": false,
      +      "type": "boolean"
      +    },
      +    "tool": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "stored",
      +    "reason",
      +    "schema_version",
      +    "receipt_hash",
      +    "created_at",
      +    "tool",
      +    "inputs",
      +    "dataset_version",
      +    "engine_version",
      +    "result"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / _meta / properties / receipt_url
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "candidates": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "item_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "carriage_prohibited": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "conditions": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "heading": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "note": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "requirement": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "conditions_ref": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "exempt": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_category_zero": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_quantity_exceedance": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "human_review_required": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "items": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "air_only_id": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "carriage_prohibited": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "class": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "conditions_ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "not_subject_to_adr": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "points": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "quantity": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "state": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "COUNTED",
      -                        "AIR_ONLY_ID",
      -                        "NOT_SUBJECT_TO_ADR",
      -                        "BLOCKED"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "message": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "not_subject_to_adr": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "threshold": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "total_points": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "warnings": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "candidates": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "item_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "carriage_prohibited": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "conditions": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "heading": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "note": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "requirement": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "conditions_ref": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "exempt": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_category_zero": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_quantity_exceedance": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "human_review_required": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "items": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "air_only_id": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "carriage_prohibited": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "class": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "conditions_ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "not_subject_to_adr": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "points": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "quantity": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "state": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "COUNTED",
      +                        "AIR_ONLY_ID",
      +                        "NOT_SUBJECT_TO_ADR",
      +                        "BLOCKED"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "message": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_subject_to_adr": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "resolved_subtotal_points": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "threshold": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "threshold_exceeded_by_resolved_items": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "total_points": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "unresolved_item_indexes": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "type": "number"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "verdict_basis": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "all_items",
      +              "resolved_items_alone",
      +              "none"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "warnings": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
  5. Changed10 schema fields changedv2.24.0
    • addedOutput schema / properties / _meta
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "identify": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / as_of
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / blocking_errors / items / properties / recovery / properties / params / propertyNames
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / edition
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "applies_from": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "may_apply_until": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "applies_from",
      +        "may_apply_until"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / envelope_version / enum
      Previous value: -[
      -  "1",
      -  "1.1"
      -]New value: +[
      +  "1",
      +  "1.1",
      +  "1.2"
      +]
    • addedOutput schema / properties / missing_inputs
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / normalized_input / propertyNames
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "candidates": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "item_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "carriage_prohibited": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "conditions": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "heading": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "note": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "requirement": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "conditions_ref": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "exempt": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_category_zero": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_quantity_exceedance": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "human_review_required": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "items": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "air_only_id": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "carriage_prohibited": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "class": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "conditions_ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "not_subject_to_adr": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "points": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "quantity": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "state": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "COUNTED",
      -                        "AIR_ONLY_ID",
      -                        "NOT_SUBJECT_TO_ADR",
      -                        "BLOCKED"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "message": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "not_subject_to_adr": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "threshold": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "total_points": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "warnings": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "candidates": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "item_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "carriage_prohibited": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "conditions": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "heading": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "note": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "requirement": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "conditions_ref": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "exempt": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_category_zero": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_quantity_exceedance": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "human_review_required": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "items": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "air_only_id": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "carriage_prohibited": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "class": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "conditions_ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "not_subject_to_adr": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "points": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "quantity": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "state": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "COUNTED",
      +                        "AIR_ONLY_ID",
      +                        "NOT_SUBJECT_TO_ADR",
      +                        "BLOCKED"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "message": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_subject_to_adr": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "threshold": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "total_points": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "warnings": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
    • addedOutput schema / properties / status
      Added value: +{
      +  "enum": [
      +    "ok",
      +    "partial",
      +    "not_found",
      +    "unsupported",
      +    "ambiguous"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / warnings / items / properties / details / propertyNames
      Added value: +{
      +  "type": "string"
      +}
  6. Changed7 schema fields changedv2.22.3
    • addedInput schema / properties / items / items / properties / quantity / maximum
      Added value: +1000000000
    • changedInput schema / properties / items / items / properties / un_number / pattern
      Previous value: -"^(?:(?:UN)?\\d{4}|\\s*ID\\s*[-:.]?\\s*\\d{4}\\s*)$"New value: +"^(?:\\s*(?:UN\\s*)?\\d{4}\\s*|\\s*ID\\s*[-:.]?\\s*\\d{4}\\s*)$"
    • addedInput schema / properties / items / items / properties / variant_index / maximum
      Added value: +9007199254740991
    • addedInput schema / properties / items / minItems
      Added value: +1
    • addedInput schema / properties / quantity / maximum
      Added value: +1000000000
    • changedInput schema / properties / un_number / pattern
      Previous value: -"^(?:(?:UN)?\\d{4}|\\s*ID\\s*[-:.]?\\s*\\d{4}\\s*)$"New value: +"^(?:\\s*(?:UN\\s*)?\\d{4}\\s*|\\s*ID\\s*[-:.]?\\s*\\d{4}\\s*)$"
    • addedInput schema / properties / variant_index / maximum
      Added value: +9007199254740991
  7. Changed10 schema fields changedv2.20.0
    • changedInput schema / properties / basis / description
      Previous value: -"OPTIONAL. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging, so a quantity declared 'gross' returns no points in ANY unit — send the net figure instead."New value: +"OPTIONAL. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging, so a quantity declared 'gross' returns no points in ANY unit — send the net figure instead. Single-substance form only — sent beside items[] it is refused; set it on each item."
    • changedInput schema / properties / items / items / properties / un_number / description
      Previous value: -"UN number — 4 digits, optionally \"UN\"-prefixed. Example: \"1263\"."New value: +"UN number — 4 digits, optionally \"UN\"-prefixed — or an ID-prefixed air-only number such as \"ID8000\" (routed AIR_ONLY_ID; the warning on that line states the limited-quantity condition the 0 rests on). Example: \"1263\"."
    • changedInput schema / properties / items / items / properties / un_number / pattern
      Previous value: -"^(UN)?\\d{4}$"New value: +"^(?:(?:UN)?\\d{4}|\\s*ID\\s*[-:.]?\\s*\\d{4}\\s*)$"
    • changedInput schema / properties / packing_group / description
      Previous value: -"Packing group (I, II or III) — only needed to disambiguate a UN with more than one ADR Table A row (e.g. UN 1789). Ignored for single-row UNs. Single-substance form only."New value: +"Packing group (I, II or III) — only needed to disambiguate a UN with more than one ADR Table A row (e.g. UN 1789). Ignored for single-row UNs. Single-substance form only — sent beside items[] it is refused; set it on each item."
    • changedInput schema / properties / quantity / description
      Previous value: -"Quantity for the single-substance check, in kg or litres per the substance's ADR unit. Example: 100."New value: +"Quantity for the single-substance check, in kg or litres per the substance's ADR unit. Single-substance form only — sent beside items[] it is refused. Example: 100."
    • changedInput schema / properties / un_number / description
      Previous value: -"UN number for a single-substance check — 4 digits, optionally \"UN\"-prefixed. Example: \"1203\"."New value: +"UN number for a single-substance check — 4 digits, optionally \"UN\"-prefixed — or an ID-prefixed air-only number such as \"ID8000\" (routed AIR_ONLY_ID, nothing counted — the warning on that line states the limited-quantity condition). Single-substance form only — sent beside items[] it is refused; send the substance as an item. Example: \"1203\"."
    • changedInput schema / properties / un_number / pattern
      Previous value: -"^(UN)?\\d{4}$"New value: +"^(?:(?:UN)?\\d{4}|\\s*ID\\s*[-:.]?\\s*\\d{4}\\s*)$"
    • changedInput schema / properties / unit / description
      Previous value: -"OPTIONAL. The dimension `quantity` is stated in. Omit it and the number is taken as already on the ADR 1.1.3.6.3 basis (unchanged behaviour). Supply it and it is CHECKED against the dimension 1.1.3.6.3 counts for that Table A row — litres for liquids and for compressed or adsorbed gases, kilograms for solids, liquefied/refrigerated/dissolved gases and articles. A mismatch returns total_points null, exempt null and items[].basis_mismatch true, naming the dimension the entry is counted in."New value: +"OPTIONAL. The dimension `quantity` is stated in. Omit it and the number is taken as already on the ADR 1.1.3.6.3 basis (unchanged behaviour). Supply it and it is CHECKED against the dimension 1.1.3.6.3 counts for that Table A row — litres for liquids and for compressed or adsorbed gases, kilograms for solids, liquefied/refrigerated/dissolved gases and articles. A mismatch returns total_points null, exempt null and items[].basis_mismatch true, naming the dimension the entry is counted in. Single-substance form only — sent beside items[] it is refused; set it on each item."
    • changedInput schema / properties / variant_index / description
      Previous value: -"ADR Table A variant index (as returned by adr_lookup) — pins one row when a UN has several variants that share a packing group (concentration bands). Ignored for single-row UNs. Single-substance form only."New value: +"ADR Table A variant index (as returned by adr_lookup) — pins one row when a UN has several variants that share a packing group (concentration bands). Ignored for single-row UNs. Single-substance form only — sent beside items[] it is refused; set it on each item."
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "candidates": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "item_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "carriage_prohibited": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "conditions": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "heading": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "note": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "requirement": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "conditions_ref": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "exempt": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_category_zero": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_quantity_exceedance": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "human_review_required": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "items": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "carriage_prohibited": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "class": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "conditions_ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "not_subject_to_adr": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "points": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "quantity": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "message": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "not_subject_to_adr": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "threshold": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "total_points": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "warnings": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "candidates": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "item_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "carriage_prohibited": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "conditions": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "heading": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "note": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "requirement": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "conditions_ref": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "exempt": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_category_zero": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_quantity_exceedance": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "human_review_required": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "items": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "air_only_id": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "carriage_prohibited": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "class": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "conditions_ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "not_subject_to_adr": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "points": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "quantity": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "state": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "COUNTED",
      +                        "AIR_ONLY_ID",
      +                        "NOT_SUBJECT_TO_ADR",
      +                        "BLOCKED"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "message": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_subject_to_adr": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "threshold": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "total_points": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "warnings": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "type": "object"
      +  }
      +]
  8. Changed4 schema fields changedv2.17.3
    • addedInput schema / properties / basis
      Added value: +{
      +  "description": "OPTIONAL. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging, so a quantity declared 'gross' returns no points in ANY unit — send the net figure instead.",
      +  "enum": [
      +    "net",
      +    "gross"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / basis
      Added value: +{
      +  "description": "OPTIONAL. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging, so a quantity declared 'gross' returns no points in ANY unit — send the net figure instead.",
      +  "enum": [
      +    "net",
      +    "gross"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / unit
      Added value: +{
      +  "description": "OPTIONAL. The dimension `quantity` is stated in. Omit it and the number is taken as already on the ADR 1.1.3.6.3 basis (unchanged behaviour). Supply it and it is CHECKED against the dimension 1.1.3.6.3 counts for that Table A row — litres for liquids and for compressed or adsorbed gases, kilograms for solids, liquefied/refrigerated/dissolved gases and articles. A mismatch returns total_points null, exempt null and items[].basis_mismatch true, naming the dimension the entry is counted in.",
      +  "enum": [
      +    "L",
      +    "kg"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / unit
      Added value: +{
      +  "description": "OPTIONAL. The dimension `quantity` is stated in. Omit it and the number is taken as already on the ADR 1.1.3.6.3 basis (unchanged behaviour). Supply it and it is CHECKED against the dimension 1.1.3.6.3 counts for that Table A row — litres for liquids and for compressed or adsorbed gases, kilograms for solids, liquefied/refrigerated/dissolved gases and articles. A mismatch returns total_points null, exempt null and items[].basis_mismatch true, naming the dimension the entry is counted in.",
      +  "enum": [
      +    "L",
      +    "kg"
      +  ],
      +  "type": "string"
      +}
  9. Changed6 schema fields changedv2.17.2
    • addedOutput schema / properties / _source / properties / authority_current_edition
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _source / properties / checked_at
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _source / properties / dataset_edition
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / envelope_version / const
      Removed value: -"1"
    • addedOutput schema / properties / envelope_version / enum
      Added value: +[
      +  "1",
      +  "1.1"
      +]
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "candidates": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "item_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "exempt": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_category_zero": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_quantity_exceedance": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "human_review_required": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "items": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "class": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "packing_group": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "points": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "quantity": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "variant_index": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "message": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "threshold": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "total_points": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "warnings": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "candidates": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "item_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "carriage_prohibited": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "conditions": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "heading": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "note": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "requirement": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "conditions_ref": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "exempt": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_category_zero": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_quantity_exceedance": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "human_review_required": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "items": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "carriage_prohibited": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "class": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "conditions_ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "not_subject_to_adr": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "points": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "quantity": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "message": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "not_subject_to_adr": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "threshold": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "total_points": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "warnings": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "type": "object"
      +  }
      +]
  10. Changed5 schema fields changedv2.12.1
    • addedInput schema / properties / items / items / properties / packing_group
      Added value: +{
      +  "description": "Packing group for a multi-variant UN.",
      +  "enum": [
      +    "I",
      +    "II",
      +    "III"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / variant_index
      Added value: +{
      +  "description": "ADR Table A variant index for a multi-variant UN.",
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / packing_group
      Added value: +{
      +  "description": "Packing group (I, II or III) — only needed to disambiguate a UN with more than one ADR Table A row (e.g. UN 1789). Ignored for single-row UNs. Single-substance form only.",
      +  "enum": [
      +    "I",
      +    "II",
      +    "III"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / variant_index
      Added value: +{
      +  "description": "ADR Table A variant index (as returned by adr_lookup) — pins one row when a UN has several variants that share a packing group (concentration bands). Ignored for single-row UNs. Single-substance form only.",
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "exempt": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_category_zero": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "has_quantity_exceedance": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "items": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "class": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "multiplier": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "points": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "proper_shipping_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "quantity": {
      -                  "type": [
      -                    "number",
      -                    "null"
      -                  ]
      -                },
      -                "transport_category": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "un_number": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "message": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "threshold": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "total_points": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "warnings": {
      -        "anyOf": [
      -          {
      -            "items": {},
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "candidates": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "item_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "exempt": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_category_zero": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "has_quantity_exceedance": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "human_review_required": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "items": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {
      +                "class": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "multiplier": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "packing_group": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "points": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "proper_shipping_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "quantity": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "transport_category": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "un_number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "variant_index": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "message": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "threshold": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "total_points": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "warnings": {
      +        "anyOf": [
      +          {
      +            "items": {},
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "type": "object"
      +  }
      +]
  11. Changed6 schema fields changedv2.11.0
    • changedInput schema / properties / items / description
      Previous value: -"Array of items for mixed-load calculation (use instead of single un_number/quantity)"New value: +"Mixed-load items (use INSTEAD of un_number/quantity)."
    • changedInput schema / properties / items / items / properties / quantity / description
      Previous value: -"Quantity in kg or litres"New value: +"Quantity in kg or litres per the substance's ADR unit."
    • changedInput schema / properties / items / items / properties / un_number / description
      Previous value: -"UN number"New value: +"UN number — 4 digits, optionally \"UN\"-prefixed. Example: \"1263\"."
    • changedInput schema / properties / quantity / description
      Previous value: -"Quantity in kg or litres for single-substance check"New value: +"Quantity for the single-substance check, in kg or litres per the substance's ADR unit. Example: 100."
    • changedInput schema / properties / un_number / description
      Previous value: -"UN number for single-substance check"New value: +"UN number for a single-substance check — 4 digits, optionally \"UN\"-prefixed. Example: \"1203\"."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "_source": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "checked": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "provenance_status": {
      +          "enum": [
      +            "verified",
      +            "pending-verification",
      +            "computed",
      +            "live"
      +          ],
      +          "type": "string"
      +        },
      +        "source_url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "checked",
      +        "provenance_status"
      +      ],
      +      "type": "object"
      +    },
      +    "blocking_errors": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "recovery": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "action": {
      +                "type": "string"
      +              },
      +              "params": {
      +                "additionalProperties": {},
      +                "type": "object"
      +              },
      +              "tool": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "action"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "recovery"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "citation": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "qualifier": {
      +          "type": "string"
      +        },
      +        "text": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "text"
      +      ],
      +      "type": "object"
      +    },
      +    "confidence": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "basis": {
      +          "enum": [
      +            "deterministic",
      +            "provenance",
      +            "match_quality",
      +            "freshness"
      +          ],
      +          "type": "string"
      +        },
      +        "level": {
      +          "enum": [
      +            "high",
      +            "medium",
      +            "low"
      +          ],
      +          "type": "string"
      +        },
      +        "score": {
      +          "maximum": 1,
      +          "minimum": 0,
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "level",
      +        "basis"
      +      ],
      +      "type": "object"
      +    },
      +    "envelope_version": {
      +      "const": "1",
      +      "type": "string"
      +    },
      +    "normalized_input": {
      +      "additionalProperties": {},
      +      "type": "object"
      +    },
      +    "ok": {
      +      "type": "boolean"
      +    },
      +    "result": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": true,
      +          "properties": {
      +            "exempt": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "has_category_zero": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "has_quantity_exceedance": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "items": {
      +              "anyOf": [
      +                {
      +                  "items": {
      +                    "additionalProperties": true,
      +                    "properties": {
      +                      "class": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "multiplier": {
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "points": {
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "proper_shipping_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "quantity": {
      +                        "type": [
      +                          "number",
      +                          "null"
      +                        ]
      +                      },
      +                      "transport_category": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "un_number": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "message": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "threshold": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "total_points": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "warnings": {
      +              "anyOf": [
      +                {
      +                  "items": {},
      +                  "type": "array"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": {},
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "validity": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "as_of": {
      +          "type": "string"
      +        },
      +        "effective_from": {
      +          "type": "string"
      +        },
      +        "effective_to": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "as_of"
      +      ],
      +      "type": "object"
      +    },
      +    "warnings": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "details": {
      +            "additionalProperties": {},
      +            "type": "object"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "envelope_version",
      +    "ok",
      +    "result",
      +    "confidence",
      +    "_source",
      +    "citation"
      +  ],
      +  "type": "object"
      +}
  12. Changed2 schema fields changedv2.1.1
    • addedInput schema / properties / items / items / properties / un_number / pattern
      Added value: +"^(UN)?\\d{4}$"
    • addedInput schema / properties / un_number / pattern
      Added value: +"^(UN)?\\d{4}$"
  13. First observedv1.0.0

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Despite annotations already covering the safety profile (readOnly, idempotent, non-destructive), the description adds substantial behavior: unknown fields are refused by name rather than ignored, zero-only loads are refused, ambiguous UN rows yield AMBIGUOUS_UN_VARIANT with candidates instead of a guess, ID-prefixed numbers are BLOCKED without icao_limited_quantity, edition defaults to 2025 until 2027-01-01 with a transitional basis plus strict_adr_2027 comparison, and rate-limit errors carry reset_at. This is far beyond what the annotations convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The rule statement is front-loaded and useful, but the prose is dense and repetitive — the ID-number BLOCKED condition is stated twice in consecutive sentences, and the full category-maximum table (20/333/1,000/unlimited/0) reads like reference text rather than invocation guidance. It is long for a single tool definition and could be tightened without losing behavior.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 11-parameter tool with nested items[], four enums, an output schema and non-obvious edition/transitional semantics, the description covers the qualifying rule, the variant-resolution path, ID-number handling, defaults and error shapes. Nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3, but the description adds real meaning: 0 means not carried, gross is only an upper bound so send net, packing_group/variant_index are required to resolve multi-row UNs, and the edition/as_of precedence is spelled out. Some of this duplicates the schema, so it stops short of 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence names a specific verb and resource (exemption points for a dangerous-goods road load under ADR 1.1.3.6) and states the formula (points = quantity x transport category multiplier). It then explicitly separates itself from adr_lq_eq_check, adr_lookup and adr_consignment_check so an agent can route without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit alternatives with the condition that selects each ('For limited/excepted quantity relief use adr_lq_eq_check; for a substance's row ... adr_lookup; for the whole ADR picture ... adr_consignment_check'). Also states the mutually exclusive input shapes (un_number + quantity OR items[], never both) and that category 0 can never use the exemption.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.