Global Economy & Trade

HS commodity codes in US trade

Changed on

The Harmonized System codes the monthly US trade series publishes at one level (HS2 chapters, HS4 headings, HS6 subheadings) with the Census short description. parent narrows HS4 or HS6 to the codes under one shorter code.

get/api/v1/census/trade/commodities

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/census/trade/commodities
  • Auth: API key in header x-api-key

Query parameters

flowstring

exports or imports

levelstring

HS2, HS4 or HS6

parentstring nullable

Keep only codes under this shorter HS code (27 -> 2701..2716).

Response

HS codes and descriptions at the requested level.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes