lookup_license
Look up a license
Look up a cannabis or hemp business license by license number or business name on the state lists TerraVault reads (CA, CO, CT, DC, FL, IL, MA, MD, ME, MN, MO, NJ, NV, NY, OH, OR, VT, WA). Returns the license type, status as the state prints it, city and county, the date the list was read, the state's own record link and the TerraVault page. Never returns phone numbers, emails or owner details.
Parametersqueryrequiredstate
licensed_near
Licensed stores near a place
Find licensed cannabis stores and delivery services near a ZIP code, or near a city in a given state, nearest first, from the state's own license lists. Each result has its distance, how the distance was measured, and its TerraVault page. A result of kind "maker" is a New York microbusiness that sells only what it grows and makes itself. A license is not a promise a store is open or has an item.
Parameterszipcitykindlimitmilesstate
organic_growers
OCal organic-standard growers
List cannabis growers and distributors certified under OCal, California's comparable-to-organic standard, from the state's own list, with links to their TerraVault license pages where the name matches. Optional city or county filter. California only.
Parameterscitycounty
state_license_counts
License counts for a state
Count the active cannabis licenses on one state's list, by license type, with the date the list was last read and the state agency that publishes it.
Parametersstaterequired
check_recall
Check a California cannabis recall
Check a cannabis package or license against California's own cannabis recall list. Give the package UID, a batch number with its maker, or a license number. Answers RECALLED only on an exact match, SOLD_RECALLED_PRODUCT when the state lists the license only as a store that sold a recalled product, NOT_IN_INDEX with the date the list was read, or NOT_CHECKED when it cannot say. Never answers that a product is safe. California only.
ParametersuidbatchmakerlicenseNumber
state_license_report
Monthly license report for a state
One state's monthly cannabis license report from its own published list: licenses at the start and end of the month, first seen, left and came back, by license type, county and city. Reports start October 2026. Defaults to the month in progress.
Parametersmonthstaterequired
marys_desk
Today's cannabis license and recall update
Mary's Desk: TerraVault's short daily update from its own records. Licenses first seen on or gone from each state's published list since the previous update, new California cannabis recalls, and California's month-to-date license report. Every line names its source and the date it was read. Returns the latest day by default, up to the last 7.
Parametersdays