Servidor MCP
FreightUtils MCP Server
io.github.SoapyRED/freightutils
Qué hace este MCP
Provides freight and customs reference lookups, dangerous-goods checks, transport calculations, shipment sizing, emissions estimates, and logistics identifier validation.
Capacidades
Herramientas
25
herramientas
adr_exemption_calculator
ADR 1.1.3.6 Exemption Calculator
Calculate ADR 1.1.3.6 "small load" exemption points for a dangerous-goods load. Each substance's transport category (0-4) sets a points multiplier (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 with a 50 kg per-transport-unit cap); points = quantity x multiplier, and a load totalling 1,000 points or less qualifies for reduced ADR requirements. 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 mixed load (items takes precedence if both are given). Quantities are in kg or litres per the substance's ADR unit.
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; 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.
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. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: items[] (each with packing_group, variant_index, transport_category, multiplier, points, 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 â 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).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'unit': {'enum': ['L', 'kg'], 'type': 'string', 'description': "OPTIONAL. The dimension `quantity` is stated in â\x80\x94 'L' or 'kg'. Omit it and the number is taken as already on the ADR 1.1.3.6.3 basis (the historical contract). Supply it and it is CHECKED against the dimension 1.1.3.6.3 counts for the row: litres for liquids and for compressed or adsorbed gases, kilograms for solids, liquefied/refrigerated/dissolved gases and articles. A mismatch returns no points and says which dimension the entry is counted in."}, 'basis': {'enum': ['net', 'gross'], 'type': 'string', 'description': "OPTIONAL. 'net' or 'gross'. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging, so a figure declared 'gross' returns no points in ANY unit â\x80\x94 send the net quantity instead."}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['un_number', 'quantity'], 'properties': {'unit': {'enum': ['L', 'kg'], 'type': 'string', 'description': "OPTIONAL. The dimension `quantity` is stated in â\x80\x94 'L' or 'kg'. Omit it and the number is taken as already on the ADR 1.1.3.6.3 basis (the historical contract). Supply it and it is CHECKED against the dimension 1.1.3.6.3 counts for the row: litres for liquids and for compressed or adsorbed gases, kilograms for solids, liquefied/refrigerated/dissolved gases and articles. A mismatch returns no points and says which dimension the entry is counted in."}, 'basis': {'enum': ['net', 'gross'], 'type': 'string', 'description': "OPTIONAL. 'net' or 'gross'. ADR 1.1.3.6.3 counts the dangerous goods themselves, never the packaging, so a figure declared 'gross' returns no points in ANY unit â\x80\x94 send the net quantity instead."}, 'quantity': {'type': 'number', 'description': 'Quantity on the ADR 1.1.3.6.3 basis: net kg for solids and liquefied, refrigerated or dissolved gases; litres for liquids; receptacle water capacity in litres for compressed or adsorbed gases and chemicals under pressure; articles as the mass of the articles without their packagings, in kg.', 'exclusiveMinimum': 0}, 'un_number': {'type': 'string', 'pattern': '^(UN)?\\d{4}$', 'description': 'UN number (4 digits, optionally "UN"-prefixed)'}, 'packing_group': {'enum': ['I', 'II', 'III'], 'type': 'string', 'description': 'Packing group for a multi-variant UN.'}, 'variant_index': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'ADR Table A variant index for a multi-variant UN.'}}}, 'description': 'Array of items for mixed-load check'}, 'quantity': {'type': 'number', 'description': 'Quantity on the ADR 1.1.3.6.3 basis: net kg for solids and liquefied, refrigerated or dissolved gases; litres for liquids; receptacle water capacity in litres for compressed or adsorbed gases and chemicals under pressure; articles as the mass of the articles without their packagings, in kg.', 'exclusiveMinimum': 0}, 'un_number': {'type': 'string', 'pattern': '^(UN)?\\d{4}$', 'description': 'UN number for single check (4 digits, optionally "UN"-prefixed)'}, 'packing_group': {'enum': ['I', 'II', 'III'], 'type': 'string', 'description': 'Packing group (I, II or III) â\x80\x94 only needed to disambiguate a UN that has more than one ADR Table A row (e.g. UN 1789). Ignored for single-row UNs.'}, 'variant_index': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'ADR Table A variant index (as returned by adr_lookup) â\x80\x94 pins one row when a UN has several variants that share a packing group (e.g. concentration bands). Ignored for single-row UNs.'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
adr_lookup
ADR Dangerous Goods Lookup
Look up European road dangerous-goods (ADR 2025) reference data for a substance: hazard class, classification code, packing group, labels, special provisions, limited/excepted quantities, transport category, tunnel restriction code and Kemler (hazard identification) number. Covers 2,939 entries across all 9 hazard classes, from UNECE ADR 2025 (ECE/TRANS/352).
Provide exactly ONE of: un_number (exact lookup â returns every packing-group variant of that UN number), search (case-insensitive partial match on the proper shipping name), or hazard_class (all entries in a class or division). un_number is normalised â "1203", "UN1203" and "un 1203" are equivalent, and normalized_input reports the correction; explosives keep their leading zero ("0004").
Behavior: read-only reference lookup; name searches return up to 50 entries, class filters up to 100. An unknown UN number or a search with no hits errors with the API's NOT_FOUND body and a retry hint. 28 Table A rows carry a scope remark instead of a packing group: those return packing_group null plus not_subject_to_adr (with conditions_ref, e.g. "5.5.3" for UN 1845 dry ice) or carriage_prohibited, and table_a_remark preserves the verbatim Table A text. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: count and results[] â per entry: un_number, proper_shipping_name, class, classification_code, packing_group, labels, special_provisions, limited_quantity, excepted_quantity, transport_category, tunnel_restriction_code, hazard_identification_number, variant_index/variant_count and, on scope-flagged rows, not_subject_to_adr/carriage_prohibited/conditions_ref/table_a_remark â under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: a factual compilation of the ADR table, not legal or compliance advice; classification remains the consignor's responsibility â verify against the current UNECE ADR text.
Related: adr_lq_eq_check (checks quantities against the LQ/EQ values returned here), adr_exemption_calculator (1.1.3.6 small-load points), consignment_calculator (flags dangerous-goods lines by UN number).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'search': {'type': 'string', 'minLength': 2, 'description': 'Case-insensitive partial match on the proper shipping name (min 2 characters). Example: "acetone".'}, 'un_number': {'type': 'string', 'pattern': '^(UN)?\\d{4}$', 'description': 'Exact UN number â\x80\x94 4 digits, optionally "UN"-prefixed; explosives keep their leading zero. Examples: "1203", "UN1203", "0004".'}, 'hazard_class': {'type': 'string', 'description': 'Filter by ADR hazard class and its divisions. Examples: "3" (flammable liquids), "6.1" (toxic), "8" (corrosive), "1.4" (an explosives division).'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
adr_lq_eq_check
ADR LQ / EQ Exemption Check
Check whether dangerous goods qualify for ADR Limited Quantity (LQ, ADR 3.4) or Excepted Quantity (EQ, ADR 3.5) relief. LQ compares each item's per-inner-packaging quantity against that substance's LQ maximum; EQ resolves the substance's E-code (E0-E5) and checks the per-inner limit, plus the per-outer limit when inner_packaging_qty is given.
Provide mode ("lq" or "eq") and 1-20 items, each with un_number, quantity and unit â ml or L for liquids, g or kg for solids; quantity is per INNER packaging, not the whole load.
Unit families: column (7a) states the limit in ONE dimension â a mass for some entries, a volume for others â and ADR supplies no density, so a mass quantity against a volume limit (or the reverse) CANNOT be compared. Those items return status 'inconclusive' with the dimension named, never a pass or a fail, and a batch holding any inconclusive item never reads overall_status 'qualifies'. Send the quantity in the unit given by lq_limit_unit to get a verdict. Multi-variant UNs: a UN number with more than one ADR Table A row (packing group / concentration variant â e.g. UN 1789 PG II LQ 1 L vs PG III LQ 5 L) needs packing_group (I|II|III) or variant_index (from adr_lookup) on that item to pin one row. A packing_group that still leaves several rows is enough when those rows agree on class, column (7a), column (7b) and scope (UN 1790 PG I: two concentration bands, both LQ 0 / E0) â the item is answered with equivalent_variants + variant_note naming the rows it holds for; only when the rows DISAGREE does it still ask for variant_index, and candidates[] then lists only that packing group's rows. With no disambiguator at all: a single-item call, or a batch where EVERY item 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, limited_quantity, excepted_quantity) and NO verdict; a MIXED batch withholds only the ambiguous item (status 'withheld', withheld true, row fields null) while the other items are answered, overall_status never reads 'qualifies' while an item is withheld, summary carries withheld, and the envelope carries human_review_required + candidates[] plus one AMBIGUOUS_UN_VARIANT warning per withheld item. Never a silently checked packing group. Single-row UNs are unchanged.
Behavior: deterministic reference check; each item gets a status and reason (an LQ value of "0" or code E0 means the relief is not permitted for that substance), with overall_status and summary counts across the batch. Table A rows listed "NOT SUBJECT TO ADR" (e.g. UN 1845 dry ice) get item status not_subject â outside ADR scope, neither a pass nor a fail â and an all-not-subject batch returns overall_status not_applicable; "CARRIAGE PROHIBITED" rows are not_permitted with the prohibition stated in reason. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: mode, overall_status (qualifies | does_not_qualify | partial | not_applicable | inconclusive), items[] (un_number, variant_index, substance, class, packing_group, lq_limit or eq_code, quantity_entered, status â within_limit | exceeds_limit | not_permitted | not_subject | inconclusive | withheld â reason, scope flags where applicable, withheld + ambiguity_reason on a withheld item, and equivalent_variants + variant_note when a packing group resolved by equivalence), summary {total_items, qualifying, exceeding, not_permitted, not_subject?, inconclusive?, withheld?}, the ADR chapter references, and human_review_required + candidates[] when any item is withheld â all under result â or, when every item is ambiguous, human_review_required + candidates[] with blocking_errors, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: a quantity-threshold check only â LQ/EQ relief also requires packaging, marking and documentation conformity that this tool does not assess; not legal advice, verify against the current UNECE ADR text.
Related: adr_lookup (the per-substance LQ/EQ values + variant_index), adr_exemption_calculator (the 1.1.3.6 load-points route instead).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode', 'items'], 'properties': {'mode': {'enum': ['lq', 'eq'], 'type': 'string', 'description': "Check mode: 'lq' (Limited Quantity, ADR 3.4) or 'eq' (Excepted Quantity, ADR 3.5)"}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['un_number', 'quantity', 'unit'], 'properties': {'unit': {'enum': ['ml', 'L', 'g', 'kg'], 'type': 'string', 'description': 'Unit for the quantity: "ml" or "L" for liquids, "g" or "kg" for solids.'}, 'quantity': {'type': 'number', 'description': 'Quantity per inner packaging, expressed in the chosen unit. Example: 0.5.', 'exclusiveMinimum': 0}, 'un_number': {'type': 'string', 'pattern': '^(UN)?\\d{4}$', 'description': 'UN number â\x80\x94 4 digits, optionally "UN"-prefixed; explosives keep the leading zero. Examples: "1203", "UN1263", "0004".'}, 'packing_group': {'enum': ['I', 'II', 'III'], 'type': 'string', 'description': 'Packing group (I, II or III) â\x80\x94 only needed to disambiguate a UN with more than one ADR Table A row (e.g. UN 1789: PG II LQ 1 L vs PG III LQ 5 L). Ignored for single-row UNs.'}, 'variant_index': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'ADR Table A variant index (as returned by adr_lookup) â\x80\x94 pins one row when a UN has several variants that share a packing group (e.g. concentration bands). Ignored for single-row UNs.'}, 'inner_packaging_qty': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'EQ mode only: number of inner packagings per outer package, for the per-outer limit check. Default 1. Example: 10.', 'exclusiveMinimum': 0}}}, 'maxItems': 20, 'minItems': 1, 'description': 'Items to check (1â\x80\x9320 per call).'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
airline_lookup
Airline / AWB Prefix Lookup
Search 6,357 airlines by name, IATA code, ICAO code, AWB prefix, or country. AWB prefixes are the first 3 digits of an air waybill number and identify the issuing carrier (e.g. 176 = Emirates).
Provide ONE parameter: query is a ranked fuzzy search across names and codes; iata / icao / prefix / country are exact filters.
Behavior: read-only; fuzzy query hits report their match quality through the envelope's confidence (basis match_quality, score 0-1) with a FUZZY_BEST_MATCH advisory naming the matched field; a query with no hits returns count 0 with a NO_MATCH advisory rather than an error. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: count and results[] â per airline: airline_name, iata_code, icao_code, awb_prefix[], callsign, country, has_cargo, aliases and per-record verification fields â under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: this dataset's provenance is pending independent verification (the envelope's provenance_status says so) â confirm operationally critical codes with IATA/ICAO or the carrier.
Related: airport_lookup (searches AIRPORTS, not carriers), validate (checks an AWB number's check digit and names its airline from this dataset).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'iata': {'type': 'string', 'pattern': '^[A-Za-z0-9]{2}$', 'description': 'Exact IATA code (2 alphanumeric chars)'}, 'icao': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Exact ICAO code (3 letters)'}, 'query': {'type': 'string', 'minLength': 2, 'description': 'General search (name, code, prefix or country â\x80\x94 min 2 chars)'}, 'prefix': {'type': 'string', 'pattern': '^\\d{3}$', 'description': 'AWB prefix (3 digits)'}, 'country': {'type': 'string', 'minLength': 2, 'description': 'Filter by country name (min 2 chars)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
airport_lookup
Airport Code Lookup
Look up an airport by IATA code (3 letters, e.g. "LHR"), ICAO code (4 chars, e.g. "EGLL"), or free-text name/city search (e.g. "heathrow"). Covers 85,555 airports worldwide (OurAirports, public domain, cross-checked vs OpenFlights + Wikidata).
Provide ONE of iata, icao, or query; the optional type filter narrows results. Behavior: read-only; exact code hits return one record; ambiguous name searches return ranked candidates (exact codes first, then larger airports) with match quality reported via the envelope's confidence (basis match_quality); an unknown code errors with a not-found message. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: count and results[] â per airport: IATA + ICAO/ident, name, type (large/medium/small/heliport/closed/seaplane), municipality, region, country, latitude/longitude and elevation_ft â under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: reference data only â not for navigation; verify operationally critical codes with IATA / ICAO.
Related: nearest_airport (find airports FROM a coordinate), airline_lookup (searches CARRIERS / AWB prefixes, not airports), unlocode_lookup (general transport locations, of which airports are one function).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'iata': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Exact IATA code (3 letters)'}, 'icao': {'type': 'string', 'pattern': '^[A-Za-z0-9]{4}$', 'description': 'Exact ICAO / ident (4 chars)'}, 'type': {'enum': ['large_airport', 'medium_airport', 'small_airport', 'heliport', 'closed', 'seaplane_base'], 'type': 'string', 'description': 'Optional filter by airport type'}, 'query': {'type': 'string', 'minLength': 2, 'description': 'Name / city / municipality search (min 2 chars)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
cbm_calculator
CBM Calculator
Calculate cubic metres (CBM) for a shipment from per-piece dimensions. CBM is the standard volume unit in international shipping: 1 CBM = 1m x 1m x 1m = 1,000 litres, and ocean freight prices per "freight tonne" (1 CBM or 1,000 kg, whichever is greater).
Behavior: deterministic â identical inputs always return identical figures; total volume = pieces x per-piece CBM, with conversions to cubic feet, cubic inches and litres included. Missing or non-positive dimensions error with a validation message naming the parameter. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: cbm_per_piece, total_cbm, cubic_feet, litres, cubic_inches and pieces under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Related: chargeable_weight_calculator (air billing weight from the same dims), consignment_calculator (multi-line totals), unit_converter (single conversions), shipment_summary (full composite analysis).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['length_cm', 'width_cm', 'height_cm'], 'properties': {'pieces': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Number of identical pieces (default: 1)', 'exclusiveMinimum': 0}, 'width_cm': {'type': 'number', 'description': 'Width in centimetres', 'exclusiveMinimum': 0}, 'height_cm': {'type': 'number', 'description': 'Height in centimetres', 'exclusiveMinimum': 0}, 'length_cm': {'type': 'number', 'description': 'Length in centimetres', 'exclusiveMinimum': 0}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
chargeable_weight_calculator
Chargeable Weight Calculator
Calculate air freight chargeable weight â the greater of actual gross weight and volumetric weight, which is what airlines bill. Volumetric weight (kg) = (L x W x H in cm) / divisor; the IATA-standard divisor is 6,000 (1 CBM = 166.67 kg), while express integrators (DHL, FedEx, UPS) typically use 5,000.
Behavior: deterministic; per-piece volumetric weight is rounded to 2 decimal places before totalling; basis reports which weight governs ("volumetric" = cargo is light for its size, "actual" = dense). Air mode only â sea W/M (1 CBM = 1,000 kg) is covered by consignment_calculator with mode=sea. Missing or non-positive inputs error with the failing parameter named. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: chargeable_weight_kg, basis, volumetric_weight_kg (total and per piece), gross_weight_kg, cbm, ratio, factor and pieces under result; normalized_input echoes the interpreted inputs and any defaults applied; plus confidence, _source and citation (the FreightUtils v1 response envelope).
Related: cbm_calculator (volume only), consignment_calculator (multi-line, all modes), uld_lookup (the equipment the freight flies in).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['length_cm', 'width_cm', 'height_cm', 'gross_weight_kg'], 'properties': {'factor': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Volumetric divisor (default: 6000)', 'exclusiveMinimum': 0}, 'pieces': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Number of identical pieces (default: 1)', 'exclusiveMinimum': 0}, 'width_cm': {'type': 'number', 'description': 'Width in centimetres', 'exclusiveMinimum': 0}, 'height_cm': {'type': 'number', 'description': 'Height in centimetres', 'exclusiveMinimum': 0}, 'length_cm': {'type': 'number', 'description': 'Length in centimetres', 'exclusiveMinimum': 0}, 'gross_weight_kg': {'type': 'number', 'description': 'Actual gross weight in kilograms', 'exclusiveMinimum': 0}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
consignment_calculator
Consignment Calculator
Calculate per-line and grand totals for a multi-item mixed consignment: CBM, loading metres (LDM), volumetric weight, and the mode-specific chargeable figure (air chargeable weight, sea revenue tonnes, road LDM), plus objective advisory flags.
Provide mode (sea | air | road, default road) and either lines[] (canonical â per line: quantity, dims {l,w,h,unit}, weight {value,unit}, optional description / hs_code / un_number / stackable) or the legacy flat items[] (dimensions in cm, weight in kg). Air uses an IATA volumetric divisor (default 6000, settable via options.air_volumetric_divisor); options.container_number / options.awb_number add a check-digit sanity flag.
Behavior: deterministic; flags are advisory only â implausible density, mode/option mismatch, dangerous-goods presence by UN number against ADR 2025, and container/AWB check-digit validity â and never state that a shipment is permitted or compliant. Invalid lines error naming the offending field. Canonical schema: https://www.freightutils.com/schema/consignment.v1.json. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: schema_version, mode, per_line[] (cbm, gross_weight_kg, density, volumetric_weight_kg, ldm, revenue_tonnes, chargeable_weight_kg), totals (incl. billing_basis) and flags[] under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: best-effort deterministic calculation and reference data â not regulatory, customs or dangerous-goods compliance advice; classification, documentation and carrier acceptance remain your responsibility.
Related: cbm_calculator / chargeable_weight_calculator / ldm_calculator (single-figure versions), shipment_summary (adds vehicle/container suggestion and duty estimates), adr_lookup (what a flagged UN number is).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mode': {'enum': ['sea', 'air', 'road'], 'type': 'string', 'description': 'Transport mode: sea | air | road (default road). Selects the chargeable-weight basis.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['length', 'width', 'height', 'gross_weight'], 'properties': {'width': {'type': 'number', 'description': 'Width in cm', 'exclusiveMinimum': 0}, 'height': {'type': 'number', 'description': 'Height in cm', 'exclusiveMinimum': 0}, 'length': {'type': 'number', 'description': 'Length in cm', 'exclusiveMinimum': 0}, 'hs_code': {'type': 'string', 'description': 'Optional HS commodity code'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Number of pieces (default 1)', 'exclusiveMinimum': 0}, 'stackable': {'type': 'boolean', 'description': 'Can the item be stacked?'}, 'un_number': {'type': 'string', 'description': 'Optional UN number for dangerous-goods reference'}, 'description': {'type': 'string', 'description': 'Item description'}, 'pallet_type': {'enum': ['none', 'euro', 'uk', 'us', 'custom'], 'type': 'string', 'description': 'Pallet type (informational)'}, 'gross_weight': {'type': 'number', 'description': 'Gross weight per piece in kg', 'exclusiveMinimum': 0}}}, 'maxItems': 50, 'minItems': 1, 'description': 'Deprecated flat alias â\x80\x94 dimensions in cm, weight in kg. Prefer "lines". Provide lines OR items.'}, 'lines': {'type': 'array', 'items': {'type': 'object', 'required': ['quantity', 'dims', 'weight'], 'properties': {'dims': {'type': 'object', 'required': ['l', 'w', 'h', 'unit'], 'properties': {'h': {'type': 'number', 'description': 'Height in the given unit', 'exclusiveMinimum': 0}, 'l': {'type': 'number', 'description': 'Length in the given unit', 'exclusiveMinimum': 0}, 'w': {'type': 'number', 'description': 'Width in the given unit', 'exclusiveMinimum': 0}, 'unit': {'enum': ['mm', 'cm', 'm', 'in'], 'type': 'string', 'description': 'Dimension unit: mm | cm | m | in'}}, 'additionalProperties': False}, 'weight': {'type': 'object', 'required': ['value', 'unit'], 'properties': {'unit': {'enum': ['kg', 'g', 't', 'lb'], 'type': 'string', 'description': 'Weight unit: kg | g | t | lb'}, 'value': {'type': 'number', 'description': 'Gross weight per piece in the given unit', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'hs_code': {'type': 'string', 'pattern': '^\\d{6,10}$', 'description': 'Optional HS commodity code'}, 'quantity': {'type': 'integer', 'maximum': 100000, 'description': 'Number of identical pieces', 'exclusiveMinimum': 0}, 'stackable': {'type': 'boolean', 'description': 'Whether the line may be stacked two-high (halves its loading-metre footprint)'}, 'un_number': {'type': 'string', 'pattern': '^(UN)?\\d{4}$', 'description': 'Optional UN number for dangerous-goods reference'}, 'description': {'type': 'string', 'maxLength': 200, 'description': 'Optional item label'}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1, 'description': 'Canonical consignment lines (preferred). Each: { quantity, dims:{l,w,h,unit}, weight:{value,unit}, optional description / hs_code / un_number / stackable }.'}, 'options': {'type': 'object', 'properties': {'awb_number': {'type': 'string', 'maxLength': 20, 'description': 'IATA 11-digit air waybill number â\x80\x94 check-digit validated, advisory only'}, 'container_number': {'type': 'string', 'maxLength': 20, 'description': 'ISO 6346 container number â\x80\x94 check-digit validated, advisory only'}, 'air_volumetric_divisor': {'type': 'number', 'maximum': 10000, 'description': 'IATA volumetric divisor in cm³/kg (default 6000). Only affects air.', 'exclusiveMinimum': 0}}, 'description': 'Optional: { air_volumetric_divisor, container_number, awb_number }.', 'additionalProperties': False}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
container_lookup
Container Lookup
Get ISO shipping-container specifications, with optional load-fit maths. Covers 10 types: 20ft/40ft standard, 40ft and 45ft high-cube, 20ft/40ft reefer, 20ft/40ft open-top and 20ft/40ft flat-rack.
Provide type as a slug (e.g. "20ft-standard", "40ft-high-cube") for one container's record; omit it to list all 10. Add item dimensions (item_length_cm/width_cm/height_cm, optional item_weight_kg and item_quantity) to also compute how many such items fit.
Behavior: read-only reference data with per-record provenance (sources, audited_at, decision_rationale); an unknown type errors with the valid slug list. Fit calculations are geometric best-effort â they do not model load distribution, securing or mixed cargo. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: the container record â internal/external/door dimensions (cm), capacity_cbm, tare_weight_kg, max_gross_kg, max_payload_kg and euro/GMA pallet counts â under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: manufacturer-typical specs, provenance pending independent verification (the envelope's provenance_status says so) â actual equipment varies by lessor and line; confirm against the carrier's equipment guide.
Related: validate (checks a container NUMBER's ISO 6346 check digit â not specs), cbm_calculator / consignment_calculator (the cargo volume to fill it), uld_lookup (the air-freight equivalent).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'type': {'type': 'string', 'minLength': 2, 'description': 'Container slug (e.g., "20ft-standard", "40ft-high-cube"). Omit to list all.'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
emissions_calculator
Freight Emissions Calculator
Estimate freight transport greenhouse-gas emissions (kgCO2e) for a shipment leg, per ISO 14083:2023 / GLEC Framework v3.2: emissions = mass x distance x a published emission-intensity factor (kgCO2e/tonne-km).
Provide mass + distance_km + mode (road | rail | sea | air | inland_waterway); optionally choose sub_mode, region/authority (uk = DEFRA, us = EPA, fr = ADEME) and basis (wtw default, or ttw). IMPORTANT: pass ACTUAL GROSS MASS, not chargeable/volumetric weight (a common air-freight mistake â see mass_basis in the result). Distance must be provided â this tool does NOT route, geocode, or compute distances.
Behavior: deterministic given the same factor edition; the fleet-average factor already includes average empty running (see empty_running) â do NOT add your own empty-return leg; sea and air are low-representativeness generic defaults (real emissions vary materially by vessel/aircraft, load factor and routing â see representativeness and the result summary). An unknown mode/sub_mode/region returns available:false with the covered options, never a fabricated factor. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: well-to-wheel AND tank-to-wheel emissions where the factor has both, the exact factor used (value, authority, edition), the tonne-km activity and a per-result _source citing BOTH the ISO method and the specific open factor, all under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: best-effort reference estimate from open factors (DEFRA / EPA / ADEME) â NOT a verified or audited carbon report.
Related: distinct from cbm_calculator / ldm_calculator / chargeable_weight_calculator (those size or bill a shipment; this one estimates its CO2e).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mass', 'distance_km', 'mode'], 'properties': {'mass': {'type': 'number', 'description': 'Shipment mass, expressed in mass_unit. Example: 1000', 'exclusiveMinimum': 0}, 'mode': {'enum': ['road', 'rail', 'sea', 'air', 'inland_waterway'], 'type': 'string', 'description': 'Transport mode'}, 'basis': {'enum': ['wtw', 'ttw'], 'type': 'string', 'description': 'Emissions basis: wtw = well-to-wheel incl. upstream energy (default), ttw = tank-to-wheel / operation only'}, 'region': {'enum': ['uk', 'us', 'fr'], 'type': 'string', 'description': 'Factor source/region: uk = DEFRA, us = EPA, fr = ADEME. Default is per-mode.'}, 'sub_mode': {'type': 'string', 'description': 'Optional sub-mode / vehicle class (e.g. "articulated", "container ship", "long-haul"). Omit for the representative default; an unknown value returns available:false with the covered list.'}, 'mass_unit': {'enum': ['kg', 'tonnes'], 'type': 'string', 'description': 'Unit for mass (default: kg)'}, 'distance_km': {'type': 'number', 'description': 'Transport distance in kilometres â\x80\x94 you provide it; the tool does not route or compute distance', 'exclusiveMinimum': 0}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
get_subscribe_link
FreightUtils Subscribe Link
Get the URL where the user can subscribe to FreightUtils Pro for higher API limits (50,000 requests/month). Use when the user asks how to upgrade or about pricing, or after any other tool errors with a 429 rate_limited body.
Behavior: static local response â no API call, never rate-limited.
Returns: url, tier, monthly_limit, monthly_price, currency and note under result. Hand the URL to the USER to open in a browser â agents must NOT attempt to complete the subscription themselves.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'tier': {'enum': ['pro'], 'type': 'string', 'description': 'Tier to surface (only "pro" supported today)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
hs_code_lookup
HS Code Lookup
Search 6,940 WCO Harmonized System (HS 2022) commodity codes â the 6-digit international customs classification layer. The first 2 digits are the chapter, 4 the heading, 6 the subheading.
Provide ONE of: query (free-text description search, min 2 chars), code (2-6 digit lookup, returns the code plus its hierarchy), or section (Roman numeral I-XXI to browse a section).
Behavior: read-only; description search is keyword-based against official HS descriptions, so everyday product words can return zero rows â count 0 with an empty results[] is a valid answer (e.g. "laptop" and "computers" find nothing; "automatic data" matches the official phrasing "automatic data processing machines"); prefer the formal tariff wording. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: the query/code echo, count and results[] (hscode, description and hierarchy context) under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: the 6-digit international level only â national tariff lines (8-10 digits) and duty rates are set per country; classification here is indicative, not a binding ruling.
Related: uk_duty_calculator (duty/VAT for a code found here), ics2_check (EU ENS goods-description quality â a different check entirely).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'code': {'type': 'string', 'pattern': '^\\d{2,6}$', 'description': 'Exact HS code (2-6 digits)'}, 'query': {'type': 'string', 'minLength': 2, 'description': 'Search by product description (min 2 chars)'}, 'section': {'type': 'string', 'pattern': '^[ivxIVX]{1,5}$', 'description': 'Browse by section (Roman numeral Iâ\x80\x93XXI)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
ics2_check
ICS2 Stop-Words Checker
Check a goods description against the official EU ICS2 stop-words list â terms the European Commission deems too vague or generic for an entry summary declaration (ENS) goods-description field (data element 18 05 000 000).
Pass description=<goods description>. Behavior: deterministic term matching against the in-force EU list; each flagged term carries a note (a standalone stop-word means automatic rejection, an embedded one means make the description more specific); clean=true means no listed term matched â it does NOT guarantee acceptance, and no binary accepted/rejected verdict is given. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: the description echo, flagged[] (term + note), clean, caveat and disclaimer under result, plus a _source citing the EU list and legal basis, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: STRICTLY a reference check â not an ENS filing, not a customs-compliance determination, not legal advice; the EU list is non-exhaustive and updated periodically.
Related: hs_code_lookup (commodity codes â a different field of the ENS), uk_duty_calculator (duty/VAT, unrelated to ENS screening). Use BEFORE filing an ENS â for customs/documentation teams, brokers and agents building filing pipelines.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['description'], 'properties': {'description': {'type': 'string', 'description': 'The goods description to check against the EU ICS2 stop-words list.'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
incoterms_lookup
Incoterms 2020 Lookup
Look up the 11 Incoterms 2020 trade rules â who pays for transport, insurance and customs clearance, and where risk transfers from seller to buyer. 7 rules work for any transport mode (EXW, FCA, CPT, CIP, DAP, DPU, DDP); 4 are sea/inland-waterway only (FAS, FOB, CFR, CIF).
Provide code for one rule, category (any_mode | sea_only) for a filtered list, or neither to list all 11. Behavior: read-only reference; an unknown code errors with the valid code list. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: the rule record â name, category, summary, seller_responsibility, buyer_responsibility, risk_transfer, cost_transfer, insurance, export/import clearance, best_for and watch_out â under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: summarised guidance on ICC Incoterms 2020; the ICC publication is the binding text and specific contract wording prevails.
Related: uk_duty_calculator (accepts an incoterm when composing the CIF value), shipment_summary (composite analysis).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'code': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Incoterm code (3 letters, e.g., "FOB", "CIF")'}, 'category': {'enum': ['any_mode', 'sea_only'], 'type': 'string', 'description': 'Filter by mode'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
ldm_calculator
LDM Calculator
Calculate loading metres (LDM) for European road freight â how much trailer length a pallet load occupies. 1 LDM = 1 linear metre of a 2.4m-wide trailer; a standard artic is 13.6 LDM.
Provide a pallet preset OR custom length_mm + width_mm â omitting both errors with a usage hint. Behavior: deterministic; stackable=true with stack_height 2 or 3 divides the floor footprint accordingly; fits reports whether the load fits the chosen vehicle's LENGTH (give weight_kg to also see total_weight_kg against the vehicle's max payload); utilisation_percent is of the vehicle's length. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: ldm, vehicle (name, length_m, max_payload_kg), utilisation_percent, pallet_spaces (used/available), total_weight_kg, fits and warnings under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Related: vehicle_lookup (the trailer specs behind the vehicle presets), pallet_fitting_calculator (boxes onto one pallet), consignment_calculator (mixed lines including LDM).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pallet': {'enum': ['euro', 'uk', 'half', 'quarter'], 'type': 'string', 'description': 'Pallet preset'}, 'vehicle': {'enum': ['artic', 'rigid10', 'rigid75', 'luton', 'us53', 'us48', 'custom'], 'type': 'string', 'description': 'Vehicle type. DEPRECATED: rigid10 (removal in 3.0.0) â\x80\x94 its 10 m length is published by no manufacturer; use custom with vehicle_length_m, or artic.'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Number of pallets (default: 1)', 'exclusiveMinimum': 0}, 'width_mm': {'type': 'number', 'description': 'Custom pallet width in mm', 'exclusiveMinimum': 0}, 'length_mm': {'type': 'number', 'description': 'Custom pallet length in mm', 'exclusiveMinimum': 0}, 'stackable': {'type': 'boolean', 'description': 'Can pallets be stacked?'}, 'weight_kg': {'type': 'number', 'description': 'Weight per pallet in kg', 'exclusiveMinimum': 0}, 'stack_height': {'type': 'integer', 'maximum': 3, 'minimum': 2, 'description': 'Stack height 2 or 3'}, 'vehicle_length_m': {'type': 'number', 'description': 'Custom vehicle length in m', 'exclusiveMinimum': 0}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
nearest_airport
Nearest Airport
Find the airports nearest to a caller-provided latitude/longitude, sorted by great-circle (haversine) distance with distance_km on each result. Searches 85,555 airports (OurAirports, public domain).
Provide latitude and longitude (decimal degrees); optional radius_km, max_results (1-50, default 10) and type filter (e.g. large_airport only). Coordinates are INPUT only â nothing is stored or logged.
Behavior: deterministic distance sort; confidence reflects proximity and airport size (a large airport within 25 km scores high; closed/heliport/seaplane results cap lower). This tool does NOT geocode place names and does NOT compute routes â pass coordinates you already hold. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: count and results[] (the airport record plus distance_km) under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: reference data only â not for navigation; verify codes with IATA / ICAO.
Related: airport_lookup (exact code or name lookup, no distance), unlocode_lookup (named transport-location search).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['latitude', 'longitude'], 'properties': {'type': {'enum': ['large_airport', 'medium_airport', 'small_airport', 'heliport', 'closed', 'seaplane_base'], 'type': 'string', 'description': 'Optional filter by airport type'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in decimal degrees (-90 to 90)'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (-180 to 180)'}, 'radius_km': {'type': 'number', 'description': 'Optional maximum distance in kilometres', 'exclusiveMinimum': 0}, 'max_results': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results to return (1â\x80\x9350, default 10)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
pallet_fitting_calculator
Pallet Fitting Calculator
Calculate how many identical boxes fit on a pallet: boxes per layer (trying 90-degree rotation when allowed), layer count within the max height, totals, volume utilisation and weight capping.
Behavior: deterministic geometric packing of one box size in aligned rows and columns â it does not model interlocked or mixed-orientation patterns; weight_limited reports when max_payload_kg caps the count below the geometric fit; pallet_deck_height_cm defaults to 15. Missing or non-positive dimensions error naming the parameter. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: boxes_per_layer, layers, total_boxes, orientation, boxes_per_row/col, usable_height_cm, utilisation_percent, total_box_volume_cbm, wasted_space_cbm and the weight fields under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: a theoretical best-effort fit â real stacking obeys carton strength, overhang and load-stability rules it does not model.
Related: ldm_calculator (pallets into trailer length), vehicle_lookup (pallet capacity per vehicle), container_lookup (pallets into containers).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pallet_length_cm', 'pallet_width_cm', 'pallet_max_height_cm', 'box_length_cm', 'box_width_cm', 'box_height_cm'], 'properties': {'box_width_cm': {'type': 'number', 'description': 'Box width in cm', 'exclusiveMinimum': 0}, 'box_height_cm': {'type': 'number', 'description': 'Box height in cm', 'exclusiveMinimum': 0}, 'box_length_cm': {'type': 'number', 'description': 'Box length in cm', 'exclusiveMinimum': 0}, 'box_weight_kg': {'type': 'number', 'description': 'Box weight in kg', 'exclusiveMinimum': 0}, 'allow_rotation': {'type': 'boolean', 'description': 'Allow 90-degree rotation (default: true)'}, 'max_payload_kg': {'type': 'number', 'description': 'Max pallet payload in kg', 'exclusiveMinimum': 0}, 'pallet_width_cm': {'type': 'number', 'description': 'Pallet width in cm', 'exclusiveMinimum': 0}, 'pallet_length_cm': {'type': 'number', 'description': 'Pallet length in cm', 'exclusiveMinimum': 0}, 'pallet_max_height_cm': {'type': 'number', 'description': 'Max stack height in cm', 'exclusiveMinimum': 0}, 'pallet_deck_height_cm': {'type': 'number', 'description': 'Pallet deck height (default: 15cm)', 'exclusiveMinimum': 0}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
resolve_reference
Resolve Freight Reference
Resolve an arbitrary freight identifier â one opaque string in, typed and cited candidates out. The agent front door: when you hold an identifier-ish token ("176", "UN1845", "NLRTM", "FOB", "22G1", "MSKU1100810", "D/E") and do not know which lookup tool fits, call this FIRST and follow the candidate's api_url / canonical_url (or the matching sibling tool) for depth.
Provide q: ONE identifier (single token, max 32 chars). Thirteen grammars all run â UN numbers, AWB prefixes, airline IATA/ICAO, airport IATA/ICAO, UN/LOCODE, ISO 6346 container numbers (check digit computed), HS codes (6-10 digits; national lines resolve at their 6-digit international parent), Incoterms, ADR tunnel codes, ULD serials, ISO container size/type codes. Ambiguity is the product: colliding grammars return MULTIPLE ranked candidates ("LHR" is Heathrow AND an Egyptian carrier's ICAO), never a silent guess.
Behavior: deterministic â normalize (trim, uppercase, collapse spaces/dashes, strip a UN prefix), match ALL grammars, rank by record-hit > verification status > static dataset prior (airlines/adr/unlocode first) > stable tiebreak; every candidate carries rank_basis so the ordering is inspectable. Zero candidates is a VALID result (count 0 + note), never an error. A failed container check digit returns a candidate with valid:false rather than dropping it. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: query, normalized, count and candidates[] â each with entity_type, identifier_type, value_normalized, summary, record (the core fields the matching dataset holds), verification_status + verification_basis, rank_basis, canonical_url, api_url and a per-candidate dataset citation â under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: v1 is SINGLE-TOKEN resolution, not free-text extraction â pass one identifier, not a manifest line; SCAC/BIC codes are not yet covered; a match asserts the identifier is known/well-formed, not that a shipment exists.
Related: every lookup tool this resolves into â adr_lookup, airline_lookup, airport_lookup, unlocode_lookup, hs_code_lookup, incoterms_lookup, container_lookup, uld_lookup, validate.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'maxLength': 32, 'minLength': 1, 'description': 'One freight identifier â\x80\x94 e.g. "176", "UN1845", "NLRTM", "FOB", "LHR", "22G1", "MSKU1100810", "090111", "AKE12345AB", "D/E".'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
shipment_summary
Shipment Summary
Composite shipment analysis in one call: volume (CBM), gross and chargeable weight, road LDM with pallet spaces and a vehicle suggestion (road mode), volumetric weight (air), revenue tonnes with a container suggestion (sea), dangerous-goods presence for items carrying un_number, and UK duty estimates for items carrying hs_code + customs_value.
Provide mode (road | air | sea | multimodal) and items[] (dims in cm, weight in kg, quantity; optional stackable, pallet_type, hs_code, un_number, customs_value); origin/destination and incoterm refine the duty leg.
Behavior: calls the ldm_calculator, adr_lookup and uk_duty_calculator engines directly; CBM, volumetric weight and revenue tonnes are the same arithmetic inline rather than a call out. Road LDM uses the 2.40 m loading-metre convention divisor and, like ldm_calculator, treats an item with no stackable flag as NOT stacked. modeSpecific.palletSpaces is pallet FLOOR POSITIONS (the figure ldm_calculator reports); palletRows is the separate row count. Sections that cannot run (e.g. duty without a customs value) surface in warnings instead of failing the whole call. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: mode, itemCount, totals {pieces, grossWeight, volumeCBM, chargeableWeight, billingBasis}, modeSpecific (LDM / pallet floor positions / pallet rows / suggested vehicle, or revenue tonnes / container), warnings and dataVersion (road mode attributes the vehicle dataset and the LDM divisor) under result â note this composite's result uses camelCase field names (legacy shape); plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: a planning summary, not a quotation or compliance determination.
Related: consignment_calculator (canonical snake_case lines[] shape with advisory flags), cbm_calculator, chargeable_weight_calculator, ldm_calculator, adr_lookup, uk_duty_calculator. ldm_calculator, adr_lookup and uk_duty_calculator are the engines this actually calls; the rest are the single-purpose equivalents of arithmetic it does inline.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode', 'items'], 'properties': {'mode': {'enum': ['road', 'air', 'sea', 'multimodal'], 'type': 'string', 'description': 'Transport mode'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['length', 'width', 'height', 'weight', 'quantity'], 'properties': {'width': {'type': 'number', 'description': 'Width cm', 'exclusiveMinimum': 0}, 'height': {'type': 'number', 'description': 'Height cm', 'exclusiveMinimum': 0}, 'length': {'type': 'number', 'description': 'Length cm', 'exclusiveMinimum': 0}, 'weight': {'type': 'number', 'description': 'Gross weight kg per item'}, 'hs_code': {'type': 'string'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'stackable': {'type': 'boolean', 'description': 'Whether this item can be stacked (affects pallet fitting calc)'}, 'un_number': {'type': 'string'}, 'description': {'type': 'string'}, 'pallet_type': {'enum': ['euro', 'uk', 'us', 'custom', 'none'], 'type': 'string', 'description': 'Pallet standard the item sits on, if any'}, 'adr_quantity': {'type': 'number', 'description': 'ADR 1.1.3.6.3 quantity for this dangerous-goods line, in adr_quantity_unit. SEPARATE from weight, which is gross package mass â\x80\x94 1.1.3.6.3 counts none of its four categories that way. Supply both on EVERY dangerous-goods line and adrFlags.totalPoints is calculated; omit either and it stays null.', 'exclusiveMinimum': 0}, 'customs_value': {'type': 'number'}, 'adr_quantity_unit': {'enum': ['L', 'kg'], 'type': 'string', 'description': 'Dimension of adr_quantity. Checked against the dimension 1.1.3.6.3 counts for the row â\x80\x94 a litres row given kilograms still withholds the total.'}}}, 'description': 'Array of shipment items with dimensions, weight, and optional HS/UN codes'}, 'origin': {'type': 'object', 'required': ['country'], 'properties': {'locode': {'type': 'string'}, 'country': {'type': 'string'}}, 'description': 'Origin location â\x80\x94 ISO country code and optional UN/LOCODE'}, 'incoterm': {'type': 'string', 'description': "Incoterms 2020 three-letter code (e.g. 'DAP', 'EXW', 'FOB')"}, 'destination': {'type': 'object', 'required': ['country'], 'properties': {'locode': {'type': 'string'}, 'country': {'type': 'string'}}, 'description': 'Destination location â\x80\x94 ISO country code and optional UN/LOCODE'}, 'freight_cost': {'type': 'number', 'description': 'Optional freight cost in GBP for duty calculation'}, 'insurance_cost': {'type': 'number', 'description': 'Optional insurance cost in GBP for duty calculation'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
uk_duty_calculator
UK Duty & VAT Calculator
Estimate UK import duty and VAT for a commodity code using the LIVE GOV.UK Trade Tariff â rates are fetched per request, not from a static table. The CIF value is composed from customs_value + freight_cost + insurance_cost; duty = CIF x the duty rate for the origin country; VAT (typically 20%) applies on the duty-inclusive value.
Provide commodity_code (6-10 digits), origin_country (ISO-2) and customs_value in GBP; freight_cost, insurance_cost and incoterm are optional refinements.
Behavior: live lookup plus deterministic arithmetic on the returned rate; an unknown or non-declarable commodity code errors with HMRC's message (a 6-digit code may need extending to its 8/10-digit declarable line); origin-dependent measures the tariff cannot resolve automatically surface in warnings. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: commodity_code and description, origin country, cif_value, duty_rate (+ percent), duty_amount, vat_rate, vat_amount, total_import_taxes, total_landed_cost and warnings under result; validity.as_of marks the live-rate timestamp; plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: an estimate, not a customs ruling â excise, quotas, anti-dumping measures, reliefs and origin-proof requirements can change the outcome; confirm with a customs broker or HMRC before relying on it.
Related: hs_code_lookup (find the 6-digit code first), incoterms_lookup (who actually pays these costs).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['commodity_code', 'origin_country', 'customs_value'], 'properties': {'incoterm': {'enum': ['EXW', 'FCA', 'FAS', 'FOB', 'CFR', 'CIF', 'CPT', 'CIP', 'DAP', 'DPU', 'DDP'], 'type': 'string', 'description': 'Incoterm basis'}, 'freight_cost': {'type': 'number', 'description': 'Freight cost in GBP (default 0)'}, 'customs_value': {'type': 'number', 'description': 'Customs value in GBP', 'exclusiveMinimum': 0}, 'commodity_code': {'type': 'string', 'pattern': '^\\d{6,10}$', 'description': 'UK tariff commodity code (6-10 digits)'}, 'insurance_cost': {'type': 'number', 'description': 'Insurance cost in GBP (default 0)'}, 'origin_country': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': 'ISO 2-letter country of origin (e.g. "CN", "US")'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
uld_lookup
Air Cargo ULD Lookup
Look up air-cargo ULD (Unit Load Device) specifications â 16 types spanning lower-deck containers (AKE/LD3 and family), main-deck pallets (PMC, PAG and family) and temperature-controlled units. Each record carries external/internal/door dimensions (cm), tare and max gross weight (kg), usable volume (m³), deck position and compatible aircraft.
Provide type as an IATA code ("AKE", "PMC") or slug ("ake-ld3"); omit it to list all 16; category (container | pallet | special) and deck (lower | main) filter the list.
Behavior: read-only; an unknown type errors with the valid list; per-record provenance (sources, audited_at, decision_rationale) is included. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: the ULD record (or filtered list) under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: specs are compiled from manufacturer and carrier-published sources with â¥7 cited sources per record. Provenance is PENDING, not verified â read the envelope's provenance_status rather than this sentence. Second-agent coverage is now COMPLETE â every cited record-URL pairing has been opened and verdicted by a second agent, and 145 of 148 citations carry a timestamped read (the 3 without one were never opened, and say so). COVERAGE IS NOT AGREEMENT, which is why provenance is still pending: reading every page is what made the disagreements visible, not what resolved them. The second agent also WITHDRAWS stamps â pages a first pass had confirmed turned out not to list the code, or to disagree once somebody read the words around them â so treat an unstamped citation as evidence that was tried and failed, not evidence not yet gathered. CORROBORATION IS COUNTED BY PUBLISHER, NOT BY URL: the 148 citations resolve to 125 distinct sources, because several records cite one publisher at several of its own addresses (one carrier's pallet table appears in three of its documents) and several forwarders republish a single upstream template. Two citations of the same source cannot corroborate each other, so a long source list is not the same as a well-corroborated record. Treat tare_weight with particular caution: it is confirmed by no non-tertiary source on 13 of the 16 records. PGA's 565 kg is now read-confirmed by one carrier (Cathay, basis stated on the page as including nets) while two other carrier pages publish 535 kg and 505-545 kg on that same basis, so it is the top of a contested band rather than an agreed figure. Confidence is medium and a PROVENANCE_PENDING advisory rides every response. Pallet records (PMC, PAG, PGA, PLA, PAJ, PMCQ7) have NO internal dimensions â a pallet has no walls or roof; read max_build_up_height_cm for the aircraft contour ceiling and do not multiply dimensions to get a volume. Airline-specific ULD variants still differ; confirm operationally critical dimensions with the carrier.
Related: chargeable_weight_calculator (what the cargo inside is billed at), container_lookup (the sea-freight equivalent), airline_lookup (whose aircraft it flies on).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'deck': {'enum': ['lower', 'main'], 'type': 'string', 'description': 'Filter by deck position'}, 'type': {'type': 'string', 'minLength': 2, 'description': 'ULD code (e.g., "AKE", "PMC") or slug (e.g., "ake-ld3"). Omit to list all.'}, 'category': {'enum': ['container', 'pallet', 'special'], 'type': 'string', 'description': 'Filter by ULD category'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
unit_converter
Unit Converter
Convert freight and logistics units: weight (kg, lbs, oz, tonnes, short_tons, long_tons), volume (cbm, cuft, cuin, litres, gal_us, gal_uk), length (cm, inches, m, feet, mm), plus two freight-specific targets valid only FROM cbm â chargeable_kg (air volumetric weight at the IATA 6,000 divisor, 1 CBM = 166.67 kg) and freight_tonnes (sea W/M, 1 CBM = 1 freight tonne).
Behavior: deterministic; the response names both units and states the formula used. Cross-dimension conversions (e.g. kg to litres) and freight targets from a non-cbm source error with the accepted-unit list. Note: short ton (US) = 2,000 lb, long ton (UK) = 2,240 lb, metric tonne = 2,204.6 lb. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: input {value, unit, name}, result {value, unit, name}, formula and note under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Related: cbm_calculator (dimensions to volume first), chargeable_weight_calculator (proper air billing weight with pieces and a custom divisor).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value', 'from', 'to'], 'properties': {'to': {'enum': ['kg', 'lbs', 'oz', 'tonnes', 'short_tons', 'long_tons', 'cbm', 'cuft', 'cuin', 'litres', 'gal_us', 'gal_uk', 'cm', 'inches', 'm', 'feet', 'mm', 'chargeable_kg', 'freight_tonnes'], 'type': 'string', 'description': 'Target unit â\x80\x94 any source unit, plus the freight targets chargeable_kg and freight_tonnes (only valid from cbm)'}, 'from': {'enum': ['kg', 'lbs', 'oz', 'tonnes', 'short_tons', 'long_tons', 'cbm', 'cuft', 'cuin', 'litres', 'gal_us', 'gal_uk', 'cm', 'inches', 'm', 'feet', 'mm'], 'type': 'string', 'description': 'Source unit â\x80\x94 weight (kg, lbs, oz, tonnes, short_tons, long_tons), volume (cbm, cuft, cuin, litres, gal_us, gal_uk) or length (cm, inches, m, feet, mm)'}, 'value': {'type': 'number', 'description': 'Value to convert'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
unlocode_lookup
UN/LOCODE Lookup
Search 116,232 UN/LOCODE transport locations worldwide â ports, airports, rail and road terminals, inland container depots and border crossings. Codes are 5 characters: a 2-letter ISO country code + a 3-character location code (GBLHR = London Heathrow, NLRTM = Rotterdam).
Provide code for an exact record, or query (name search, min 2 chars) optionally narrowed by country and function_type; limit caps results (default 20, max 100).
Behavior: read-only; exact code hits are provenance-based while fuzzy name hits report match quality via the envelope's confidence (basis match_quality); an unknown code errors with a not-found message. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: the location record(s) â code, name and name_ascii, country, subdivision, functions[], status, coordinates {lat, lon} and iata_code where assigned â under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: an administrative code list (UNECE UN/LOCODE 2025-1) â confirm operational status and coordinates with the port or authority before critical use.
Related: airport_lookup (airport-specific records including ICAO codes), nearest_airport (find airports by coordinates).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'code': {'type': 'string', 'pattern': '^[A-Za-z0-9]{5}$', 'description': 'Exact UN/LOCODE lookup (e.g. "GBLHR", "NLRTM")'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max results (default 20)'}, 'query': {'type': 'string', 'minLength': 2, 'description': 'Search by name or code (e.g. "Rotterdam", "GBLHR", "LHR")'}, 'country': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': 'ISO 2-letter country code filter (e.g. "GB", "NL")'}, 'function_type': {'enum': ['port', 'airport', 'rail', 'road', 'icd', 'border'], 'type': 'string', 'description': 'Filter by location function'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
validate
Freight Identifier Validator
Validate and parse freight identifiers by their public check-digit algorithms: shipping container numbers (ISO 6346), air waybill (AWB) numbers (IATA modulus-7) and IMO ship identification numbers.
Two modes: pass text=<arbitrary string> to find and validate every identifier in it (e.g. a booking-email line), OR pass value=<identifier> + type=<container|awb|imo> to validate one.
Behavior: deterministic check-digit arithmetic; per identifier found it reports type, the normalised form, valid (pass/fail), expected vs actual check digit, and details (container: owner prefix + equipment category; AWB: airline prefix + the operating airline resolved from the AWB-prefix dataset; IMO: the 7-digit number); text mode with no identifiers found returns an empty found[] with a note. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: found[] (each entry with its own _source naming the standard applied) and disclaimer under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: STRUCTURAL ONLY â a valid check digit means well-formed, NOT that the container, shipment or vessel exists or is active; not a registry or tracking lookup.
Related: container_lookup (container TYPE specs, not numbers), airline_lookup (the AWB-prefix dataset the airline resolution uses).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'text': {'type': 'string', 'description': 'Arbitrary string to scan for container / AWB / IMO identifiers (parse mode). Provide this OR value+type.'}, 'type': {'enum': ['container', 'awb', 'imo'], 'type': 'string', 'description': 'Identifier type for value: container = ISO 6346, awb = IATA Air Waybill, imo = IMO ship number.'}, 'value': {'type': 'string', 'description': 'A single identifier to validate (typed mode). Requires type.'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
vehicle_lookup
Vehicle Lookup
Look up road-freight vehicle and trailer specifications â 17 types: EU articulated trailers (standard/mega curtainsider, box, reefer, double-deck, flatbed, low-loader), US 53ft/48ft dry vans, rigid trucks (7.5-26 t) and vans (Luton, Transit, Sprinter). Each record carries internal dimensions, payload and gross weights, euro/UK pallet capacity, axle configuration and features.
Provide slug (e.g. "standard-curtainsider") for one record; omit it to list all 17; category (articulated | rigid | van) and region (EU | US) filter the list.
Behavior: read-only; an unknown slug errors with the valid list; per-record provenance (sources, audited_at, decision_rationale) is included. Rate-limited (anonymous use: 25 requests/day per IP): a 429 error body carries retry_after_seconds and a Retry-After header â back off and retry, or call get_subscribe_link for higher limits.
Returns: the vehicle record (or filtered list) under result, plus confidence, _source and citation (the FreightUtils v1 response envelope).
Limitations: typical specs, provenance pending independent verification (the envelope's provenance_status says so) â real equipment varies by operator and build; legal payload is set by the vehicle's plated weights.
Related: ldm_calculator (whether a pallet load fits), pallet_fitting_calculator, consignment_calculator.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'slug': {'type': 'string', 'minLength': 2, 'description': 'Vehicle slug (e.g., "standard-curtainsider"). Omit to list all.'}, 'region': {'enum': ['EU', 'US'], 'type': 'string', 'description': 'Filter by region'}, 'category': {'enum': ['articulated', 'rigid', 'van'], 'type': 'string', 'description': 'Filter by category'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['envelope_version', 'ok', 'result', 'confidence', '_source', 'citation'], 'properties': {'ok': {'type': 'boolean'}, 'result': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, '_source': {'type': 'object', 'required': ['name', 'checked', 'provenance_status'], 'properties': {'name': {'type': 'string'}, 'checked': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'source_url': {'type': 'string'}, 'dataset_edition': {'type': 'string'}, 'provenance_status': {'enum': ['verified', 'pending-verification', 'computed', 'live'], 'type': 'string'}, 'authority_current_edition': {'type': 'string'}}, 'additionalProperties': False}, 'citation': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string'}, 'qualifier': {'type': 'string'}}, 'additionalProperties': False}, 'validity': {'type': 'object', 'required': ['as_of'], 'properties': {'as_of': {'type': 'string'}, 'effective_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'effective_from': {'type': 'string'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string'}, 'details': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'confidence': {'type': 'object', 'required': ['level', 'basis'], 'properties': {'basis': {'enum': ['deterministic', 'provenance', 'match_quality', 'freshness'], 'type': 'string'}, 'level': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'score': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'blocking_errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'message', 'recovery'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'recovery': {'type': 'object', 'required': ['action'], 'properties': {'tool': {'type': 'string'}, 'action': {'type': 'string'}, 'params': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'envelope_version': {'enum': ['1', '1.1'], 'type': 'string'}, 'normalized_input': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': False}
Historial
Cambios recientes en herramientas
Añadido
ics2_check
17 de September de 2026 a las 12:52
Añadido
validate
17 de September de 2026 a las 12:52
Añadido
emissions_calculator
17 de September de 2026 a las 12:52
Añadido
adr_lq_eq_check
17 de September de 2026 a las 12:52
Añadido
get_subscribe_link
17 de September de 2026 a las 12:52
Añadido
vehicle_lookup
17 de September de 2026 a las 12:52
Añadido
uld_lookup
17 de September de 2026 a las 12:52
Añadido
shipment_summary
17 de September de 2026 a las 12:52
Añadido
uk_duty_calculator
17 de September de 2026 a las 12:52
Añadido
unlocode_lookup
17 de September de 2026 a las 12:52
Añadido
consignment_calculator
17 de September de 2026 a las 12:52
Añadido
unit_converter
17 de September de 2026 a las 12:52
Añadido
pallet_fitting_calculator
17 de September de 2026 a las 12:52
Añadido
incoterms_lookup
17 de September de 2026 a las 12:52
Añadido
hs_code_lookup
17 de September de 2026 a las 12:52
Añadido
container_lookup
17 de September de 2026 a las 12:52
Añadido
resolve_reference
17 de September de 2026 a las 12:52
Añadido
nearest_airport
17 de September de 2026 a las 12:52
Añadido
airport_lookup
17 de September de 2026 a las 12:52
Añadido
airline_lookup
17 de September de 2026 a las 12:52
Añadido
adr_exemption_calculator
17 de September de 2026 a las 12:52
Añadido
adr_lookup
17 de September de 2026 a las 12:52
Añadido
ldm_calculator
17 de September de 2026 a las 12:52
Añadido
chargeable_weight_calculator
17 de September de 2026 a las 12:52
Añadido
cbm_calculator
17 de September de 2026 a las 12:52
Descubrir
Servidores MCP similares
SupplyGraph.AI Data
io.github.SupplyGraphAI/daasmart
Provides China-focused location, surrounding-area, company, industry-chain, property, population, retail, and regional business i…
EasyTerritory MCP
ai.easyterritory/ezt-mcp
Builds, balances, analyzes, and edits sales or service territories, with geocoding, routing, scheduling, map visualization, and G…
Ny Dmv
io.github.pipeworx-io/ny-dmv
Provides New York DMV data on vehicle registrations, electric-vehicle adoption, licensed facilities, DMV offices, road-test sites…
Predicthq
io.github.pipeworx-io/predicthq
Finds and retrieves PredictHQ events, including categories, impact rankings, dates, attendance estimates, and nearby locations.
Vessel Tracking
io.github.pipeworx-io/vessel-tracking
Provides live AIS-based ship positions, vessel details, and receiver coverage checks for geographic areas or specific vessels.
Or Dmv
io.github.pipeworx-io/or-dmv
Provides Oregon DMV office locations and live queue lengths, including wait times and customer counts.
Mo Dmv
io.github.pipeworx-io/mo-dmv
Finds Missouri license offices and provides addresses, hours, contact details, coordinates, managers, and closure dates.
Sonar Connections
com.sonarconnections/sonar-connections
Provides business details, appointment availability, menus and pickup times, event schedules, venue booths, city datasets, and GI…