{
  "opencollection": "1.0.0",
  "info": {
    "name": "UN Comtrade Data Bulk Download Tariffline Data API",
    "version": "1.0.0"
  },
  "items": [
    {
      "info": {
        "name": "Tariffline Data",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Tariffline Trade Data",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://comtradeapi.un.org/data/v1/getTariffline/:typeCode/:freqCode/:clCode",
            "params": [
              {
                "name": "typeCode",
                "value": "C",
                "type": "path",
                "description": "Trade type: C for Goods (Commodities), S for Services"
              },
              {
                "name": "freqCode",
                "value": "A",
                "type": "path",
                "description": "Reporting frequency: A for Annual, M for Monthly"
              },
              {
                "name": "clCode",
                "value": "HS",
                "type": "path",
                "description": "Commodity classification code: HS (latest), H5–H0 (HS revisions), S4–S0 (SITC revisions), B4/B3 (BEC), EB02 (Extended BEC)"
              },
              {
                "name": "reporterCode",
                "value": "840",
                "type": "query",
                "description": "UN M49 numeric country code for the reporting country. Comma-separated for multiple. E.g. 156 for China, 840 for USA."
              },
              {
                "name": "period",
                "value": "2023",
                "type": "query",
                "description": "Year (YYYY for annual) or year-month (YYYYMM for monthly). Multiple values comma-separated, max 12 values."
              },
              {
                "name": "cmdCode",
                "value": "TOTAL",
                "type": "query",
                "description": "Commodity code(s), comma-separated. Use TOTAL for aggregate."
              },
              {
                "name": "partnerCode",
                "value": "0",
                "type": "query",
                "description": "UN M49 numeric country code for the partner country. Use 0 for World."
              },
              {
                "name": "flowCode",
                "value": "X",
                "type": "query",
                "description": "Trade flow: M=Import, X=Export, MIP=Import in-transit, XIP=Export in-transit, MOP=Import of goods for outward processing, XOP=Export for outward processing, RM=Re-import, RX=Re-export"
              },
              {
                "name": "format",
                "value": "",
                "type": "query",
                "description": "Response format: json (default), csv, or txt"
              },
              {
                "name": "includeDesc",
                "value": "",
                "type": "query",
                "description": "Include commodity and country description labels in the response."
              }
            ],
            "auth": {
              "type": "apikey",
              "key": "Ocp-Apim-Subscription-Key",
              "value": "{{Ocp-Apim-Subscription-Key}}",
              "placement": "header"
            }
          },
          "docs": "Extract tariffline-level trade data with full 6-digit HS or national commodity code detail. Provides more granular breakdown than final aggregated data. Requires a valid API subscription key.\n"
        }
      ]
    }
  ],
  "bundled": true
}