Skip to main content
Glama
SoapyRED

FreightUtils MCP Server

adr_exemption_calculator

Read-onlyIdempotent

Calculate ADR 1.1.3.6 small load exemption points for dangerous goods and check whether a single substance or mixed load qualifies.

Instructions

Calculate ADR 1.1.3.6 "small load" exemption points for a dangerous-goods load and say whether it qualifies. Each substance's transport category (Table A column (15), 0-4) sets a points multiplier (1.1.3.6.4: category 1 x50, 2 x3, 3 x1, 4 x0; the nine ADR 1.1.3.6.3 note-a entries UN 0081/0082/0084/0241/0331/0332/0482/1005/1017 are x20); points = quantity x 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); note-a entries 50 kg; category 4 unlimited; category 0: 0 — however it is split across lines; goods of DIFFERENT categories qualify when the 1.1.3.6.4 points sum does not exceed 1,000. This calculator also holds every line, and every substance summed across its lines, to its category maximum — on a mixed load that is stricter than 1.1.3.6.4 (the conservative side). Transport category 0 substances can NEVER use this exemption — has_category_zero flags them.

Provide un_number + quantity for a single substance, OR items[] for a load — never both: every field of the single-substance form (un_number, quantity, packing_group, variant_index, unit, basis) sent beside items[] is refused (the API answers 400 naming the field), never dropped — put it on the item it belongs to, a substance as an item of its own. Quantities are in kg or litres per the substance's ADR unit. un_number also takes an ID-prefixed air-only number (e.g. "ID8000") — see Routing.

Multi-variant UNs: a UN number with more than one ADR Table A row (packing group / concentration variant — e.g. UN 1789 PG II vs PG III have different transport categories) needs packing_group (I|II|III) or variant_index (from adr_lookup) to pin one row. A packing_group that still leaves several rows is enough when those rows agree on class, transport category, scope and the 1.1.3.6.3 counted dimension (UN 1790 PG I: two concentration bands, both category 1) — the verdict is returned with items[].equivalent_variants + variant_note naming the rows it holds for; only when the rows DISAGREE (UN 2215 PG III: MOLTEN is category 0, the solid category 3) does it still ask for variant_index, and candidates[] then lists only that packing group's rows. With no disambiguator at all: a single-line call, or a load where EVERY line is ambiguous, returns blocking_errors[AMBIGUOUS_UN_VARIANT] + human_review_required + candidates[] (each candidate's item_index, un_number, variant_index, packing_group, proper_shipping_name, transport_category, multiplier) and NO verdict — blocking_errors is in the text content as well as structuredContent; a MIXED load withholds only the ambiguous line (items[].withheld true, points null, row fields null) while every other line keeps its points; total_points is null (1.1.3.6.4 sums every line, one term is unknown) and exempt is null UNLESS the resolved lines alone already disqualify the load — a CARRIAGE PROHIBITED entry, a category 0 entry, a per-substance maximum exceeded, or a partial sum already over 1,000 — in which case exempt is false with the ladder message (and carriage_prohibited true where that is the reason), because no packing group can undo those. warnings state the resolved lines' partial sum, candidates[] carry expected_unit (the 1.1.3.6.3 counted dimension — the only difference for UN 3375 PG II, liquid in L vs solid in kg), and the envelope carries human_review_required + candidates[] plus one AMBIGUOUS_UN_VARIANT warning per withheld line. Never a silently guessed row. Single-row UNs are unchanged.

Scope verdicts: Table A rows listed "NOT SUBJECT TO ADR" or "CARRIAGE PROHIBITED" never enter the points math. An all-not-subject load (e.g. UN 1845 dry ice) returns not_subject_to_adr true with a dedicated message ("Not subject to ADR (road). Section 5.5.3 applies: ...") and, for dry ice, conditions[] quoting the ADR 2025 section 5.5.3 requirements verbatim (ventilation, package marking, warning mark, documentation, training). A load containing a CARRIAGE PROHIBITED entry returns exempt false with carriage_prohibited true. In a mixed load, not-subject items are excluded from the points and the exclusion is stated in warnings.

Routing: every returned line carries state, in the words the FreightUtils document check uses — COUNTED (evaluated on one Table A row: its points, or a category 0 / CARRIAGE PROHIBITED row that settles the load), AIR_ONLY_ID, NOT_SUBJECT_TO_ADR, or BLOCKED (no points from the line as sent — withheld, basis_mismatch or category_unresolved; the line's own flag says which). AIR_ONLY_ID: an ID-prefixed number such as ID 8000 (consumer commodity) is an air-only identifier with no ADR Table A entry, so it gives no transport category and nothing is counted for it (items[].air_only_id true, row fields null). Each such line carries a warning stating the condition that 0 rests on: it is the ADR answer when the packages are limited quantities to the ICAO Technical Instructions (3.4.9 and 3.4.10 deem them to meet 3.4.1-3.4.4; goods exempted under 1.1.3.4.2 are not taken into account by 1.1.3.6.5) — goods not in such packages must be entered under their own UN numbers. Only the ID prefix makes a line air-only — an ID number is never read as the UN number with the same digits — and an all-air-only load returns total_points 0, exempt true with its own message, never "1.1.3.6 exemption applies" and never not_subject_to_adr.

Behavior: deterministic points arithmetic over ADR 2025 reference data; a UN that cannot be found returns blocking_errors (NOT_FOUND); exempt is the overall verdict. 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.

Returns: items[] (each with state, packing_group, variant_index, transport_category, multiplier, points, air_only_id on an ID-prefixed line, quantity_unit/quantity_basis/expected_unit when a unit or basis was declared, scope flags where applicable, withheld + ambiguity_reason on an unpinned multi-variant line, and equivalent_variants + variant_note when a packing group resolved by equivalence), total_points (NULL when no verdict was reached), threshold (1000), exempt (NULL when no verdict was reached — never false as a stand-in), has_category_zero, has_quantity_exceedance, warnings, message, human_review_required + candidates[] when any line is withheld, and — on scope verdicts — not_subject_to_adr/conditions_ref/conditions[]/carriage_prohibited under result — or, when every line is ambiguous, human_review_required + candidates[] with blocking_errors, plus confidence, _source and citation (the FreightUtils v1 response envelope).

Limitations: a deterministic calculation over reference data, not legal advice — 1.1.3.6 relieves goods carried in packages only (not in bulk or in tanks), and this calculator takes no packaging input; even exempt loads keep core duties (packaging, marking, documentation), and mixed-packing rules still apply; verify against the current UNECE ADR text.

Related: adr_lookup (per-substance data incl. transport category + variant_index), adr_lq_eq_check (the LQ/EQ relief routes instead of 1.1.3.6).

Input Schema

NameRequiredDescriptionDefault
unitNoOPTIONAL. 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.
basisNoOPTIONAL. 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.
itemsNoMixed-load items (use INSTEAD of un_number/quantity).
quantityNoQuantity 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.
un_numberNoUN 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".
packing_groupNoPacking 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.
variant_indexNoADR 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.

Output Schema

NameRequiredDescriptionDefault
okYes
resultYes
_sourceYes
citationYes
validityNo
warningsNo
confidenceYes
blocking_errorsNo
envelope_versionYes
normalized_inputNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. 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
  2. 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"
      +  }
      +]
  3. 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"
      +}
  4. 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"
      +  }
      +]
  5. 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"
      +  }
      +]
  6. 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"
      +}
  7. 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}$"
  8. First observedv1.0.0

TDQS

A4.7/5.0
Behavior5/5

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

Annotations (readOnly, idempotent, non-destructive) set a low bar, and the description goes far past them: it discloses the 400-on-mixed-fields refusal, blocking_errors/AMBIGUOUS_UN_VARIANT behavior, withheld lines, null-vs-false semantics for exempt, rate-limit reset_at, and the deterministic-not-legal-advice caveat.

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 purpose is front-loaded, but the body is an unusually long wall of text with overlapping restatements (ID/air-only behavior appears in both the Routing and scope passages, and again in the schema). Much of it earns its place for edge cases, yet the density and repetition make it harder to scan than it needs to be.

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?

Given the complexity (multi-variant UNs, mixed loads, scope verdicts, air-only IDs) and the rich output schema and annotations, the description still covers the limitations, the envelope fields, and the full edge-case taxonomy. 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 coverage is already 100%, but the description adds meaning the schema doesn't: the packing_group-equivalence rule, when variant_index is required, the ID-prefix air-only routing, and why basis='gross' yields no points. That is meaningful depth beyond the field descriptions.

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?

Opens with a specific verb+resource+outcome: 'Calculate ADR 1.1.3.6 small load exemption points for a dangerous-goods load and say whether it qualifies.' It explicitly names the relief route (1.1.3.6) and distinguishes itself from siblings by pointing to adr_lookup and adr_lq_eq_check as the alternative routes.

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?

States exactly when to use each input form (single substance vs items[]) and that they must never be combined, and names the alternative tools for the data lookup and the LQ/EQ relief routes. The Routing section gives explicit conditions under which lines are counted, withheld or rejected.

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