Public

Anonymous vendor scorecard

Anonymous. The full public scorecard for one vendor: letter grade, numeric risk score, 12-month rollups, license status flags, itemized violations and inspections, and enriched detail plus analysis narrative when available. No parameters beyond the id are needed for anonymous access. Errors return {"error":"..."}. Rate limited to 40 requests per minute per IP.

get/api/vendors/{id}/scorecard

Request

  • Base URL: https://www.venumark.com
  • URL: https://www.venumark.com/api/vendors/{id}/scorecard
  • Auth: none required

Path parameters

idstring required

Vendor id from the anonymous search results.

Response

Vendor scorecard.

gradestring

Letter grade tier, or N/A.

riskScorenumber

0-100 composite VMScore.

totalViolationsinteger

Violations in the last 12 months.

highPriorityViolationsnumber
lastInspectionDatestring
statusstring
trendstring nullable
inspections12minteger
failedInspections12minteger
scoredAtstring nullable
recommendationstring nullable
scoreBreakdownobject nullable
repeat_code_countnumber
licenseInactiveboolean
licenseExpirystring nullable
notCurrentlyLicensedboolean
isEnrichedboolean
enrichedViolationsobject[]

Itemized enriched violation detail; best-effort and may under-report vs the inspection counts.

analysisobject nullable

Narrative analysis when available: {narrative, factors, generatedAt}.

Changes

No recorded changes to this operation across all 1 revision of this API.