States

Get state profile

Detailed regulatory profile for a single state.

get/v1/states/{code}

Request

  • Base URL: https://api.hempdata.io
  • URL: https://api.hempdata.io/v1/states/{code}
  • Auth: HTTP bearer

Path parameters

codestring required

Two-letter state code (e.g. CO, CA, NY)

Response

State profile

successboolean required
metaobject

Example response

{
  "success": true,
  "data": {
    "code": "CO",
    "name": "Colorado",
    "regulations": [
      {
        "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
      }
    ],
    "regulatory_agency": "Colorado Department of Agriculture"
  },
  "errors": [
    {
      "code": "INVALID_STATE_CODE",
      "message": "Invalid state code: XX"
    }
  ]
}

Changes

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