Documentation

Everything you need to integrate HempData. Start with the overview, jump to a reference page, or skim the guides.

Try it with no key

Two endpoints work with zero signup — paste either into a terminal right now:

# Ask a question — deterministic, statute-cited answer (no key)
curl -X POST https://api.hempdata.io/v1/answer \
  -H 'Content-Type: application/json' \
  -d '{"question":"Is delta-8 legal in Texas?"}'

# Check a product/state combo on the public demo endpoint (no key)
curl "https://api.hempdata.io/v1/demo/compliance-check?state=TX&substance=cbd&product_type=edibles"

/v1/demo/compliance-check takes state (two-letter code), substance (e.g. cbd, cbg, cbn, delta-8-thc, delta-9-thc, thca), and product_type (e.g. edibles, beverages, tinctures, topicals, vape, flower). Keyless endpoints are IP rate-limited — currently 120 requests/min per IP; watch the X-Demo-IP-Limit / X-Demo-IP-Remaining response headers.

Quickstart — 60 seconds to your first call

# 1. Get a key
open https://api.hempdata.io/signup

# 2. Export it
export HEMPDATA_KEY="hda_live_sk_..."

# 3. Make a call
curl "https://api.hempdata.io/v1/compliance/check?state=KY&substance=cbd&product_type=edibles" \
  -H "Authorization: Bearer $HEMPDATA_KEY"

Use your secret key (hda_live_sk_...) for API calls; the publishable key (hda_live_pk_...) is only for the embeddable widget.

Browse