Regulations

Query regulations

Search and filter hemp regulations across jurisdictions. Supports filtering by state, substance, product type, legal status, confidence score, and verification date.

Tier-gated response fields: the set of columns returned depends on the subscriber's tier. Free returns the core record (id, jurisdiction, substance, product_type, legal_status, federal_status, thc_limits, verification metadata). Retailer adds shipping/age/license fields. Brand adds labeling, testing, enforcement, penalty, and plain_english fields. Enterprise additionally returns changelog, source_urls, source_documents, and related_bills. Lower tiers may still pass include_changelog/include_sources/include_bills=true — the params are silently ignored and meta.upgrade_hint surfaces the required tier.

get/v1/regulations

Request

  • Base URL: https://api.hempdata.io
  • URL: https://api.hempdata.io/v1/regulations
  • Auth: HTTP bearer

Query parameters

statestring required

Comma-separated list of two-letter state codes (e.g. CO,CA,NY)

substancestring

Filter by substance (e.g. delta-9-thc, cbd, delta-8-thc)

product_typestring

Filter by product type (e.g. edibles, topicals, flower, tinctures)

legal_status'legal' | 'restricted' | 'prohibited' | 'gray_area' | 'pending_change'

Filter by legal status

min_confidencenumber

Minimum confidence score (0 to 1)

verified_afterstring date

Only return regulations verified after this ISO 8601 date

include_changelogboolean

Include change history for each regulation

include_sourcesboolean

Include source URLs and documents

include_billsboolean

Include related legislative bills

pageinteger

Page number for pagination

per_pageinteger

Results per page (max 100)

format'json' | 'csv'

Response format

Response

Paginated list of regulations

successboolean required

Example response

{
  "success": true,
  "data": [
    {
      "jurisdiction": "CO",
      "substance": "delta-9-thc",
      "product_type": "edibles",
      "federal_status": "legal_under_farm_bill",
      "thc_limit_pct_dryweight": 0.3,
      "thc_limit_mg_per_serving": 10,
      "thc_limit_mg_per_container": 100,
      "thc_measurement_method": "post-decarboxylation",
      "age_restriction": 21,
      "age_verification_method": "id_scan",
      "testing_panels_required": [
        "potency",
        "pesticides",
        "heavy_metals",
        "residual_solvents",
        "microbials"
      ],
      "shipping_status": "allowed",
      "carrier_restrictions": [
        "usps"
      ],
      "license_type": "hemp_processor",
      "enforcement_agency": "Colorado Department of Agriculture",
      "penalty_range": "$500-$10,000 fine; possible license revocation",
      "plain_english": "Delta-9 THC edibles are legal in Colorado for adults 21+ with per-serving and per-package limits.",
      "confidence_score": 0.95
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 142,
    "total_pages": 6
  },
  "errors": [
    {
      "code": "INVALID_STATE_CODE",
      "message": "Invalid state code: XX"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.