Compliance requirements API
Read Stampmark’s shared compliance catalog through one public, versioned endpoint. Filter verified requirements by supported jurisdiction and business activity.
/api/v1/compliance/requirementsVerified shared data
The endpoint returns requirements from Stampmark’s shared compliance catalog. Every returned requirement is marked verified and includes one or more verified authoritative sources. Unverified sources and unverified requirements are excluded.
This endpoint does not provide access to user-owned documents or account files; it only returns shared catalog data.
Query parameters
Both filters are optional. Omit them to list all verified shared catalog requirements currently available from the endpoint.
jurisdictionstring · optional- Currently supported code: CA (California).
activitystring · optional- A seeded activity slug. See the supported values below.
Jurisdiction
CA
California
Activity
food-serviceFood servicealcohol-serviceAlcohol service
Unsupported or malformed filter · HTTP 400
The response includes an errors object keyed to the invalid field, such as activity or jurisdiction.
{"errors":{"jurisdiction":"Use a supported jurisdiction code"}}
{"errors":{"activity":"Use a supported activity slug"}}
Valid filters with no matches · HTTP 200
A valid filter combination with no matching requirements returns {"items":[]}.
When both filters are supplied, they must match the same applicability link for a requirement. A jurisdiction match on one link and an activity match on another do not combine into a result.
Request example
Set BASE_URL to the origin that serves this endpoint. The example asks for California food-service requirements.
cURL
curl --get "$BASE_URL/api/v1/compliance/requirements" \
--data-urlencode "jurisdiction=CA" \
--data-urlencode "activity=food-service"Response schema
A successful response has an items array. This HTTP 200 example uses the shipped verified food-facility record; its source URLs and checked dates come from the returned catalog record.
HTTP 200 · application/json
{
"items": [
{
"slug": "food-facility-health-permit",
"name": "Food Facility Operating Permit (Health Permit)",
"authorityDescription": "Local County Environmental Health Department (e.g. LA County Public Health, SF Dept. of Public Health)",
"citation": "California Health & Safety Code §114047",
"verificationStatus": "verified",
"effectiveFrom": null,
"effectiveThrough": null,
"sources": [
{
"slug": "food-facility-health-permit-primary-source",
"label": "CA Department of Public Health — Food Facility Program",
"url": "https://www.cdph.ca.gov/Programs/CEH/DFDCS/Pages/FDBPrograms/FoodSafetyProgram/RetailFoodProgram.aspx",
"checkedDate": "2026-09-24"
},
{
"slug": "food-facility-health-permit-secondary-1-source",
"label": "LA County Public Health — Retail Food Facility Requirements",
"url": "https://publichealth.lacounty.gov/eh/inspection/construction-requirements-retail-food-facilities.htm",
"checkedDate": "2026-09-24"
},
{
"slug": "food-facility-health-permit-secondary-2-source",
"label": "SF Office of Small Business — Restaurant Health Permit Guide",
"url": "https://www.sf.gov/guide-opening-multi-use-business-one-location",
"checkedDate": "2026-09-24"
}
]
}
]
}Requirement fields
slugstring- Stable catalog identifier.
namestring- Requirement name.
authorityDescriptionstring | null- Description of the responsible authority, when recorded.
citationstring | null- Legal citation, when recorded.
verificationStatus"verified"- Every returned requirement has verified status.
effectiveFromISO date | null- Effective start date, when recorded.
effectiveThroughISO date | null- Effective end date, when recorded.
sourcesSource[]- One or more verified sources for the requirement.
Source fields
Each source contains the fields below. checkedDate is a nullable ISO date in YYYY-MM-DD format.
slugstring- Stable source identifier.
labelstring- Readable source name.
urlstring- Authoritative source URL.
checkedDateISO date | null- Date the source was checked, when recorded.