Substances & Product Types API

These endpoints provide reference data for the substances and product types tracked by HempData API.

GET /v1/substances

List all tracked substances with their federal legal status and the number of state regulations referencing each.

Request Example

curl -X GET "https://api.hempdataapi.com/v1/substances" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

{
  "success": true,
  "data": [
    {
      "id": "delta-9-thc",
      "name": "Delta-9 THC",
      "description": "The primary psychoactive cannabinoid in cannabis. Legal in hemp-derived products at or below 0.3% dry weight under the 2018 Farm Bill.",
      "federal_status": "legal_with_restrictions",
      "federal_thc_limit": "0.3% dry weight",
      "total_state_regulations": 148,
      "states_legal": 18,
      "states_legal_with_restrictions": 22,
      "states_restricted": 4,
      "states_prohibited": 5,
      "states_unclear": 2,
      "hr5371_relevance": "high",
      "common_product_types": ["edibles", "tinctures", "topicals", "flower", "beverages", "concentrates"]
    },
    {
      "id": "delta-8-thc",
      "name": "Delta-8 THC",
      "description": "An isomer of Delta-9 THC with milder psychoactive effects. Legal status varies widely by state; not explicitly addressed in the 2018 Farm Bill.",
      "federal_status": "unclear",
      "federal_thc_limit": "N/A — derived from hemp but not explicitly regulated at federal level",
      "total_state_regulations": 102,
      "states_legal": 12,
      "states_legal_with_restrictions": 15,
      "states_restricted": 6,
      "states_prohibited": 14,
      "states_unclear": 4,
      "hr5371_relevance": "high",
      "common_product_types": ["edibles", "tinctures", "smokable", "concentrates"]
    },
    {
      "id": "cbd",
      "name": "CBD (Cannabidiol)",
      "description": "Non-psychoactive cannabinoid widely used in wellness products. Legal federally when derived from hemp with <0.3% THC.",
      "federal_status": "legal_with_restrictions",
      "federal_thc_limit": "Must be derived from hemp (<0.3% THC)",
      "total_state_regulations": 165,
      "states_legal": 30,
      "states_legal_with_restrictions": 18,
      "states_restricted": 2,
      "states_prohibited": 0,
      "states_unclear": 1,
      "hr5371_relevance": "medium",
      "common_product_types": ["edibles", "topicals", "tinctures", "beverages", "pet-products", "capsules"]
    },
    {
      "id": "thca",
      "name": "THCA (Tetrahydrocannabinolic Acid)",
      "description": "Precursor to THC that converts when heated. Regulatory treatment varies as it is non-psychoactive in raw form.",
      "federal_status": "unclear",
      "federal_thc_limit": "Debated — total THC vs. delta-9 only",
      "total_state_regulations": 64,
      "states_legal": 8,
      "states_legal_with_restrictions": 10,
      "states_restricted": 8,
      "states_prohibited": 12,
      "states_unclear": 13,
      "hr5371_relevance": "high",
      "common_product_types": ["flower", "concentrates", "edibles"]
    },
    {
      "id": "cbg",
      "name": "CBG (Cannabigerol)",
      "description": "Non-psychoactive cannabinoid sometimes called the 'mother cannabinoid.' Generally legal where CBD is legal.",
      "federal_status": "legal",
      "federal_thc_limit": "Must be derived from hemp (<0.3% THC)",
      "total_state_regulations": 38,
      "states_legal": 40,
      "states_legal_with_restrictions": 8,
      "states_restricted": 1,
      "states_prohibited": 0,
      "states_unclear": 2,
      "hr5371_relevance": "low",
      "common_product_types": ["tinctures", "topicals", "capsules"]
    },
    {
      "id": "cbn",
      "name": "CBN (Cannabinol)",
      "description": "Mildly psychoactive cannabinoid often marketed for sleep. Regulatory treatment generally follows CBD rules.",
      "federal_status": "legal",
      "federal_thc_limit": "Must be derived from hemp (<0.3% THC)",
      "total_state_regulations": 35,
      "states_legal": 38,
      "states_legal_with_restrictions": 9,
      "states_restricted": 1,
      "states_prohibited": 1,
      "states_unclear": 2,
      "hr5371_relevance": "low",
      "common_product_types": ["tinctures", "edibles", "capsules"]
    }
  ],
  "meta": {
    "total": 6,
    "request_id": "req_sub_001"
  },
  "errors": []
}

Response Fields

GET /v1/product-types

List all tracked product types with regulation counts.

Request Example

curl -X GET "https://api.hempdataapi.com/v1/product-types" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

{
  "success": true,
  "data": [
    {
      "id": "edibles",
      "name": "Edibles",
      "description": "Ingestible hemp products including gummies, chocolates, baked goods, and other food items.",
      "total_regulations": 142,
      "states_with_regulations": 48,
      "common_restrictions": ["age_requirement", "thc_per_serving_limit", "testing_required", "labeling_required"],
      "avg_confidence": 0.89
    },
    {
      "id": "topicals",
      "name": "Topicals",
      "description": "Products applied to the skin including creams, balms, lotions, and patches.",
      "total_regulations": 98,
      "states_with_regulations": 45,
      "common_restrictions": ["labeling_required", "thc_limit"],
      "avg_confidence": 0.91
    },
    {
      "id": "smokable",
      "name": "Smokable Hemp",
      "description": "Hemp flower and pre-rolls intended for smoking or vaping.",
      "total_regulations": 110,
      "states_with_regulations": 47,
      "common_restrictions": ["age_requirement", "testing_required", "ban_in_some_states"],
      "avg_confidence": 0.86
    },
    {
      "id": "tinctures",
      "name": "Tinctures",
      "description": "Liquid extracts typically administered sublingually.",
      "total_regulations": 88,
      "states_with_regulations": 44,
      "common_restrictions": ["thc_per_serving_limit", "labeling_required"],
      "avg_confidence": 0.90
    },
    {
      "id": "beverages",
      "name": "Beverages",
      "description": "Hemp-infused drinks including seltzers, teas, and other liquid consumables.",
      "total_regulations": 76,
      "states_with_regulations": 40,
      "common_restrictions": ["age_requirement", "thc_per_serving_limit", "alcohol_combination_rules"],
      "avg_confidence": 0.85
    },
    {
      "id": "flower",
      "name": "Hemp Flower",
      "description": "Raw or minimally processed hemp flower for various uses.",
      "total_regulations": 95,
      "states_with_regulations": 46,
      "common_restrictions": ["thc_limit", "testing_required", "packaging_required"],
      "avg_confidence": 0.88
    },
    {
      "id": "concentrates",
      "name": "Concentrates",
      "description": "Concentrated hemp extracts including wax, shatter, distillate, and isolate.",
      "total_regulations": 72,
      "states_with_regulations": 38,
      "common_restrictions": ["thc_limit", "testing_required", "license_required"],
      "avg_confidence": 0.83
    },
    {
      "id": "pet-products",
      "name": "Pet Products",
      "description": "Hemp products formulated for animal use including treats and tinctures.",
      "total_regulations": 45,
      "states_with_regulations": 30,
      "common_restrictions": ["no_thc_allowed", "labeling_required", "health_claims_prohibited"],
      "avg_confidence": 0.80
    }
  ],
  "meta": {
    "total": 8,
    "request_id": "req_pt_001"
  },
  "errors": []
}

Response Fields