PUBLIC APIv1 · read-only

Compliance requirements API

Read Stampmark’s shared compliance catalog through one public, versioned endpoint. Filter verified requirements by supported jurisdiction and business activity.

GET/api/v1/compliance/requirements
01

Verified 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.

PublicNo sign-inGET onlyVerified sources
02

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 service
  • alcohol-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.

03

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"
04

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.