Othermile border costs

Estimate what a shopper may pay at the door for one parcel shipped between Canada and the United States: duty, tariffs and surtaxes, sales tax and carrier or postal fees, with the official rules in force today. Describe the product in plain words; a tariff code is suggested from it. Use for questions like "what will I pay on a hoodie from a US store shipped to Ontario?"

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "enum": [
        "CA",
        "US"
      ],
      "description": "Country the parcel ships from"
    },
    "to": {
      "type": "string",
      "enum": [
        "CA",
        "US"
      ],
      "description": "Country the parcel goes to"
    },
    "province": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Province or territory when it goes to Canada, for example ON; leave out if unknown"
    },
    "mode": {
      "type": "string",
      "enum": [
        "mail",
        "courier"
      ],
      "default": "courier",
      "description": "Postal mail (USPS, Canada Post) or a courier (UPS, FedEx, Purolator, DHL); courier if unknown"
    },
    "product": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "What the product is, in a few words, for example cotton hoodie"
    },
    "tariffCode": {
      "type": "string",
      "maxLength": 20,
      "description": "The product's tariff code, only if known"
    },
    "madeIn": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "Country where the product was made, for example CN; ask if unknown"
    },
    "value": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000,
      "description": "What the goods in the parcel cost"
    },
    "currency": {
      "type": "string",
      "enum": [
        "CAD",
        "USD"
      ]
    },
    "cusmaClaim": {
      "type": "boolean",
      "description": "True only if the seller says the goods qualify for CUSMA and claims it"
    }
  },
  "required": [
    "from",
    "to",
    "product",
    "madeIn",
    "value",
    "currency"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Estimate duties, tariffs, taxes and fees for goods moving into Canada or the US, by parcel or freight (truck, rail, air, ocean), and whether any item is banned. Gives who pays under the Incoterm, and what the exporting country requires. Use before buying from or shipping across the border.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "Country the parcel ships from"
    },
    "to": {
      "type": "string",
      "enum": [
        "CA",
        "US"
      ]
    },
    "region": {
      "type": "string",
      "maxLength": 3,
      "description": "Destination province or state, for example AB or ON"
    },
    "mode": {
      "type": "string",
      "enum": [
        "mail",
        "courier",
        "road",
        "rail",
        "air",
        "sea",
        "inland_waterway"
      ],
      "description": "mail or courier for parcels (low value allowances apply); road (truck), rail, air, sea or inland_waterway for commercial freight"
    },
    "paidBy": {
      "type": "string",
      "enum": [
        "customer",
        "seller"
      ],
      "default": "customer",
      "description": "Who pays border charges: the customer at the door (DAP), or the seller in advance (DDP). Ignored when incoterm is given"
    },
    "incoterm": {
      "type": "string",
      "enum": [
        "EXW",
        "FCA",
        "CPT",
        "CIP",
        "DAP",
        "DPU",
        "DDP",
        "FAS",
        "FOB",
        "CFR",
        "CIF"
      ],
      "description": "Incoterms 2020 term of sale; FAS, FOB, CFR and CIF are for sea and inland waterway"
    },
    "freight": {
      "type": "number",
      "minimum": 0,
      "description": "International transport cost in the destination currency, to split costs by the Incoterm"
    },
    "insurance": {
      "type": "number",
      "minimum": 0,
      "description": "Cargo insurance cost in the destination currency"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date the parcel enters the destination country"
    },
    "personal": {
      "type": "boolean",
      "description": "true when a person buys the goods for their own use, as a shopper's parcel is; some surtaxes spare those. Leave out for a business import"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "hs": {
            "type": "string",
            "description": "Tariff classification (HS code), at least 4 digits, for example 6109.10"
          },
          "origin": {
            "type": "string",
            "pattern": "^[A-Z]{2}$",
            "description": "Country where the product was made, for example HN for Honduras"
          },
          "value": {
            "type": "number",
            "minimum": 0,
            "description": "Price per unit in dollars"
          },
          "currency": {
            "type": "string",
            "enum": [
              "CAD",
              "USD"
            ]
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "default": 1
          },
          "cusmaClaim": {
            "type": "boolean",
            "description": "True if the seller will claim CUSMA preference for this item"
          }
        },
        "required": [
          "hs",
          "origin",
          "value",
          "currency"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 50
    }
  },
  "required": [
    "from",
    "to",
    "mode",
    "items"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Which Canada and US border rules are in force right now: tariff measures, rates, start dates and whether each list has been checked against the official text.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

What shoppers and sellers actually paid and how long parcels actually took on a route, from real reports. Only shown when enough reports exist.

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "enum": [
        "CA",
        "US"
      ]
    },
    "from": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "Two letter country code, for example CA or US"
    },
    "mode": {
      "type": "string",
      "enum": [
        "courier",
        "mail"
      ]
    }
  },
  "required": [
    "to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}