---
title: "Scan COA numbers against all jurisdictions"
method: POST
path: "/v1/compliance/scan"
tags: ["Compliance"]
---

# Scan COA numbers against all jurisdictions

`POST /v1/compliance/scan`

## Request

- Base URL: `https://api.hempdata.io`
- URL: `https://api.hempdata.io/v1/compliance/scan`
- Auth: HTTP bearer

Submit certificate-of-analysis potency numbers and get a per-jurisdiction legality map for the finished product.

## Request body

- ComplianceScanRequest: COA numbers for a finished product. All potency fields are percentages from the certificate of analysis.
  - `total_thc_percent` number, required
  - `delta9_thc_percent` number, required
  - `thca_percent` number, required
  - `substance` string
  - `product_type` string, required
  - `serving_size_mg` number, required
  - `servings_per_container` integer, required

## Response `200`

Per-jurisdiction scan result

- object
  - `success` boolean
  - `data` object
  - `meta` object, nullable
  - `errors` unknown

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key
- `429`: Rate limit or monthly quota exceeded

---

[API](https://skmtc.dev/hempdata/apis/hempdata-api.md) · [All operations](https://skmtc.dev/hempdata/apis/hempdata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hempdata/apis/hempdata-api/revisions/2c2946badd40?raw)