Server definition
- Hash
- sha256:b8f80b279996e60577ff83c0be38bbe887c89868ccf189d4935e1771b4f57178
- What it is
- What a remote MCP server returned when asked what it offers: 4 tools
The blob, as servednamed by its sha256
{
"instructions": "{\"setup\":{\"route\":\"light\",\"scopesGranted\":null,\"createAllowedByScope\":null,\"resources\":[],\"prompts\":[],\"quotaRemaining\":null,\"quotaNote\":\"Remaining allowance is not loaded at handshake. Scan creation enforces current workspace and requester limits; inspect quota errors rather than assuming a fresh allowance.\",\"recommendedNextTool\":\"certscore_scan_site\",\"sequence\":[\"certscore_scan_site\",\"certscore_get_scan_status\",\"certscore_get_scan_bundle\"],\"guidance\":\"Light supports eligible public scans, not workspace history. For workspace access connect https://mcp.certscore.ai/mcp using OAuth. Reuse an existing Hosted OAuth connection rather than adding duplicate names.\"}}",
"tools": [
{
"description": "Use workpaper=tracking for the starting-page tracking inventory, privacy choices/notices and GPC evidence, with JSON and CSV downloads. The workpaper selector also applies to every continuation request. Otherwise retrieve scan report display content as paginated JSON, without internal diagnostic JSON downloads. The response also offers a single-file full JSON download; private JSON download links expire after five minutes and need no OAuth header; use pagination if your host blocks file downloads. Repeated display records use reportContentRef JSON Pointers. Includes evidence tables, full-site page and resource inventories, all retained additional-page form fields, form snapshot download references, and retained limitations. Snapshot images are downloaded separately from the returned URLs, with OAuth bearer authentication for workspace scans. Available on OAuth and Light. Start with scanId; follow pagination.nextCursor until complete. Pages share a snapshot; restart if it changes. Each entry has a JSON Pointer path and value; oversized strings use numbered parts. Export completion is not complete observation coverage. Use the concise scan bundle for summaries; use this tool for exhaustive report evidence. No new scan is created.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"maxLength": 100,
"type": "string"
},
"scanId": {
"format": "uuid",
"type": "string"
},
"workpaper": {
"const": "tracking",
"type": "string"
}
},
"required": [
"scanId"
],
"type": "object"
},
"name": "certscore_get_report_evidence_page",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coverage": {
"additionalProperties": false,
"properties": {
"exclusions": {
"items": {
"type": "string"
},
"type": "array"
},
"exportTruncated": {
"const": false,
"type": "boolean"
},
"observationCompleteness": {
"const": "see_report_coverage",
"type": "string"
},
"scope": {
"const": "public_report_projection",
"type": "string"
}
},
"required": [
"scope",
"exportTruncated",
"observationCompleteness",
"exclusions"
],
"type": "object"
},
"download": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"same_access_rules_as_mcp",
"short_lived_report_link",
"public"
],
"type": "string"
},
"bytes": {
"minimum": 0,
"type": "integer"
},
"csvUrl": {
"format": "uri",
"type": "string"
},
"expiresAt": {
"format": "date-time",
"type": "string"
},
"instructions": {
"type": "string"
},
"mediaType": {
"const": "application/json",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"mediaType",
"bytes",
"authentication",
"instructions"
],
"type": "object"
},
"entries": {
"items": {
"additionalProperties": false,
"properties": {
"path": {
"type": "string"
},
"stringPart": {
"minimum": 0,
"type": "integer"
},
"stringParts": {
"exclusiveMinimum": 0,
"type": "integer"
},
"value": {}
},
"required": [
"path"
],
"type": "object"
},
"type": "array"
},
"pagination": {
"additionalProperties": false,
"properties": {
"complete": {
"type": "boolean"
},
"nextCursor": {
"type": [
"string",
"null"
]
},
"offset": {
"minimum": 0,
"type": "integer"
},
"returned": {
"minimum": 0,
"type": "integer"
},
"total": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"offset",
"returned",
"total",
"complete",
"nextCursor"
],
"type": "object"
},
"reconstruction": {
"type": "string"
},
"reportUrl": {
"type": "string"
},
"scanId": {
"format": "uuid",
"type": "string"
},
"snapshot": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"type": {
"const": "certscore_report_evidence_page",
"type": "string"
},
"version": {
"const": 1,
"type": "number"
},
"workpaper": {
"const": "tracking",
"type": "string"
}
},
"required": [
"type",
"version",
"scanId",
"snapshot",
"reportUrl",
"entries",
"pagination",
"coverage",
"reconstruction"
],
"type": "object"
}
},
{
"description": "Returns the completed or completed-limited CertScore evidence bundle for a stable scanId as concise TextContent and matching structuredContent. The default summary distinguishes observed external domains from classified tracker vendors and states the public-page scope. Use detail=evidence to inspect bounded retained request examples and policy-surface candidates even when there are no findings; use certscore_get_report_evidence_page for deeper report evidence. Available sections also include retained privacy-choice controls and notice topics in privacyAuditSummary (full evidence in detail=full), canonical findings, pre-consent cookie and tracker evidence, coverage limitations, persisted execution provenance, and retrieval URLs. Detail tiers and byte budgets report returned, total, truncated, and omitted-section metadata. Accept and Reject results distinguish registered decisions from retained after-click facts. Their execution reports succeeded for a completed click and bounded observation, and succeeded_with_confirmation when the consent decision is also verified. Optional afterAction summaries remain useful when registration is unconfirmed; absent or failed capture remains explicitly limited. Consume canonical findings for any scoring effect. Results are automated public-web observations, not legal advice, certification, or a compliance determination.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"detail": {
"description": "Response detail. Defaults to summary; evidence and full opt into heavier retained context.",
"enum": [
"summary",
"findings",
"evidence",
"full"
],
"type": "string"
},
"maxBytes": {
"description": "Requested serialized structured response budget in bytes. The full profile defaults to 50000. MCP Light defaults to and applies a transport-safe 25000-byte ceiling; larger Light requests are clamped and reported in response metadata.",
"maximum": 200000,
"minimum": 5000,
"type": "integer"
},
"maxFindings": {
"description": "Maximum compact findings to return. Defaults to 5 for summary and 20 otherwise.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"maxPreConsentRows": {
"description": "Maximum compact pre-consent inventory rows to return. Defaults to 20.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"scanId": {
"description": "Stable CertScore scan ID.",
"minLength": 1,
"type": "string"
}
},
"required": [
"scanId"
],
"type": "object"
},
"name": "certscore_get_scan_bundle",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"completedAt": {
"type": [
"string",
"null"
]
},
"coverage": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"additionalProperties": true,
"properties": {
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"type": "object"
}
]
},
{
"type": "null"
}
]
},
"createdAt": {
"type": [
"string",
"null"
]
},
"detail": {
"enum": [
"summary",
"findings",
"evidence",
"full"
],
"type": "string"
},
"disclaimer": {
"type": [
"string",
"null"
]
},
"domain": {
"type": "string"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"issues": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 80,
"type": "string"
},
"field": {
"maxLength": 80,
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"field",
"code"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"mcpCode": {
"type": "integer"
},
"message": {
"type": "string"
},
"name": {
"type": "string"
},
"recommendedNextAction": {
"type": "string"
},
"responseBody": {},
"retryAfterSeconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
},
"status": {
"type": "integer"
}
},
"required": [
"code",
"message",
"retryable",
"retryAfterSeconds",
"recommendedNextAction"
],
"type": "object"
},
{
"type": "null"
}
]
},
"evidenceSummary": {
"additionalProperties": {},
"type": "object"
},
"evidenceUrlTemplate": {
"const": "{contentUrls.findings}/{findingId}",
"type": "string"
},
"findings": {
"items": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"confidence": {
"enum": [
"strong",
"good",
"moderate",
"weak",
"unknown"
],
"type": "string"
},
"criticality": {
"enum": [
"critical",
"high",
"medium",
"low",
"info",
"unknown"
],
"type": "string"
},
"detail": {
"additionalProperties": true,
"properties": {
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"recommendedReviewerQuestions": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"disclaimer": {
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"authRequiredForExamples": {
"type": "boolean"
},
"basis": {
"enum": [
"runtime_observation",
"policy_surface_detection",
"accessibility_check",
"public_report_projection"
],
"type": "string"
},
"exampleCount": {
"minimum": 0,
"type": "integer"
},
"examples": {
"items": {
"additionalProperties": false,
"properties": {
"documentUrl": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
]
},
"finalUrl": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
]
},
"frameUrl": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
]
},
"initiatorHost": {
"anyOf": [
{
"maxLength": 253,
"type": "string"
},
{
"type": "null"
}
]
},
"initiatorType": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
]
},
"initiatorUrl": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
]
},
"observedAtMs": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"pageContextId": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
]
},
"phase": {
"type": [
"string",
"null"
]
},
"projectionWarnings": {
"items": {
"maxLength": 120,
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"rawObservedVendor": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
]
},
"rawObservedVendorCategory": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
]
},
"redirectChain": {
"items": {
"maxLength": 2048,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"registrableDomain": {
"type": [
"string",
"null"
]
},
"relatedOrInitiatingVendor": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
]
},
"requestUrl": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
]
},
"resolvedEndpointVendor": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
]
},
"resolvedEndpointVendorCategory": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
]
},
"resourceType": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
]
},
"scannedPageUrl": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
]
},
"type": {
"enum": [
"request",
"page",
"accessibility_check",
"policy_surface"
],
"type": "string"
},
"urlHost": {
"type": [
"string",
"null"
]
},
"vendor": {
"type": [
"string",
"null"
]
},
"vendorAttributionBasis": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"type"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"examplesAvailable": {
"minimum": 0,
"type": "integer"
},
"examplesShown": {
"minimum": 0,
"type": "integer"
},
"excerpt": {
"additionalProperties": false,
"properties": {
"evidenceUrl": {
"maxLength": 2048,
"type": "string"
},
"excerpt": {
"type": "string"
},
"isTruncated": {
"type": "boolean"
},
"sourceUrl": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
]
},
"truncationMarker": {
"type": [
"string",
"null"
]
}
},
"required": [
"excerpt",
"isTruncated",
"truncationMarker",
"sourceUrl",
"evidenceUrl"
],
"type": "object"
},
"hasConsentContext": {
"type": "boolean"
},
"hasPolicyAnchor": {
"type": "boolean"
},
"hasTimingAnchor": {
"type": "boolean"
},
"hasVendorAnchor": {
"type": "boolean"
},
"phase": {
"type": [
"string",
"null"
]
},
"projectionWarnings": {
"items": {
"maxLength": 120,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"summary": {
"type": "string"
}
},
"required": [
"basis",
"summary",
"exampleCount",
"examplesShown"
],
"type": "object"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"links": {
"additionalProperties": true,
"properties": {
"docs": {
"type": "string"
},
"findings": {
"type": "string"
},
"latestDomainScan": {
"type": "string"
},
"pulse": {
"type": "string"
},
"report": {
"type": "string"
},
"self": {
"type": "string"
},
"status": {
"type": "string"
}
},
"type": "object"
},
"nextStep": {
"type": [
"string",
"null"
]
},
"noGo": {
"$ref": "#/properties/noGo/anyOf/0"
},
"plainEnglish": {
"type": "string"
},
"resultDisposition": {
"$ref": "#/properties/resultDisposition/anyOf/0"
},
"reviewLenses": {
"default": [],
"items": {
"type": "string"
},
"type": "array"
},
"scanId": {
"type": "string"
},
"type": {
"const": "certscore_finding",
"type": "string"
}
},
"required": [
"type",
"id",
"scanId",
"label",
"criticality",
"confidence",
"plainEnglish",
"evidence"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"confidence": {
"$ref": "#/properties/findings/items/anyOf/0/properties/confidence"
},
"criticality": {
"$ref": "#/properties/findings/items/anyOf/0/properties/criticality"
},
"evidenceUrl": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"nextStep": {
"type": "string"
},
"plainEnglish": {
"type": "string"
},
"type": {
"const": "certscore_finding",
"type": "string"
}
},
"required": [
"type",
"id",
"label",
"criticality",
"confidence",
"plainEnglish"
],
"type": "object"
}
]
},
"type": "array"
},
"findingsMetadata": {
"additionalProperties": false,
"properties": {
"returned": {
"minimum": 0,
"type": "integer"
},
"shown": {
"minimum": 0,
"type": "integer"
},
"total": {
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"shown",
"returned",
"total",
"truncated"
],
"type": "object"
},
"fullReport": {
"additionalProperties": true,
"properties": {
"agentInterpretation": {
"$ref": "#/properties/summary/properties/agentInterpretation/anyOf/0"
},
"capabilities": {
"additionalProperties": false,
"properties": {
"doesNotProvide": {
"items": {
"enum": [
"legal_advice",
"certification",
"compliance_determination"
],
"type": "string"
},
"type": "array"
},
"method": {
"const": "automated_runtime_analysis",
"type": "string"
},
"observes": {
"items": {
"enum": [
"pre_consent_tracking",
"cmp_load_order",
"third_party_requests",
"consent_enforcement_gaps",
"cookie_activity",
"accessibility_signals",
"disclosure_inconsistencies"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"method",
"observes",
"doesNotProvide"
],
"type": "object"
},
"coverage": {
"additionalProperties": true,
"properties": {
"homepageObserved": {
"type": "boolean"
},
"interruptionCount": {
"type": "integer"
},
"interruptions": {
"items": {
"additionalProperties": true,
"properties": {
"label": {
"type": "string"
},
"reason": {
"type": "string"
},
"reviewReason": {
"type": "string"
},
"reviewTitle": {
"type": "string"
}
},
"required": [
"label",
"reason"
],
"type": "object"
},
"type": "array"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"scopeSummary": {
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"type": "object"
},
"disclaimer": {
"type": "string"
},
"domain": {
"type": "string"
},
"feedback": {
"additionalProperties": true,
"properties": {
"email": {
"type": "string"
},
"feedbackUrl": {
"type": "string"
},
"negativeUrl": {
"type": "string"
},
"positiveUrl": {
"type": "string"
},
"prompt": {
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"gpcResponse": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0"
},
{
"type": "null"
}
]
},
"links": {
"additionalProperties": true,
"properties": {
"canonicalPulseUrl": {
"type": "string"
},
"docsUrl": {
"type": "string"
},
"evidenceJsonUrl": {
"type": "string"
},
"findingsReferenceUrl": {
"type": "string"
},
"fullJsonUrl": {
"type": "string"
},
"fullReportUrl": {
"type": "string"
},
"immutableFullJsonUrl": {
"type": "string"
},
"immutableJsonUrl": {
"type": "string"
},
"immutableMarkdownUrl": {
"type": "string"
},
"jsonUrl": {
"type": "string"
},
"markdownUrl": {
"type": "string"
},
"scanJsonUrl": {
"type": "string"
},
"summaryJsonUrl": {
"type": "string"
}
},
"type": "object"
},
"meta": {
"additionalProperties": true,
"properties": {
"apiVersion": {
"type": "string"
},
"detail": {
"enum": [
"tiny",
"standard",
"full",
"summary",
"evidence"
],
"type": "string"
},
"format": {
"enum": [
"json",
"markdown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"projectionVersion": {
"type": "string"
},
"pulseVersion": {
"type": "string"
},
"schemaVersion": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"noGo": {
"$ref": "#/properties/noGo/anyOf/0"
},
"postAcceptObservation": {
"anyOf": [
{
"$ref": "#/properties/postAcceptObservation/anyOf/0/anyOf/1/anyOf/0"
},
{
"type": "null"
}
]
},
"postRefusalObservation": {
"anyOf": [
{
"$ref": "#/properties/postRefusalObservation/anyOf/0/anyOf/1/anyOf/0"
},
{
"type": "null"
}
]
},
"request": {
"additionalProperties": {},
"type": "object"
},
"resultDisposition": {
"$ref": "#/properties/resultDisposition/anyOf/0"
},
"scanId": {
"type": "string"
},
"scanStatus": {
"type": "string"
},
"scan_id": {
"type": "string"
},
"summary": {
"additionalProperties": true,
"properties": {
"benchmark": {
"type": [
"string",
"null"
]
},
"coverageNote": {
"type": "string"
},
"headline": {
"type": "string"
},
"humanSummary": {
"type": "string"
},
"machineSummary": {
"additionalProperties": {},
"type": "object"
},
"riskLevel": {
"type": "string"
},
"score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
"type": "object"
},
"topFindings": {
"items": {
"additionalProperties": true,
"properties": {
"anchorUrl": {
"type": "string"
},
"confidence": {
"type": "string"
},
"criticality": {
"type": "string"
},
"evidenceDigest": {
"additionalProperties": true,
"properties": {
"authRequiredForExamples": {
"type": "boolean"
},
"basis": {
"type": "string"
},
"exampleCount": {
"type": "integer"
},
"examplesAvailable": {
"type": "integer"
},
"examplesShown": {
"type": "integer"
},
"hasConsentContext": {
"type": "boolean"
},
"hasPolicyAnchor": {
"type": "boolean"
},
"hasTimingAnchor": {
"type": "boolean"
},
"hasVendorAnchor": {
"type": "boolean"
},
"phase": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"nextStep": {
"type": "string"
},
"plainEnglish": {
"type": "string"
},
"reviewLenses": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"type": "array"
},
"transportSecurity": {
"additionalProperties": false,
"properties": {
"evidenceRetained": {
"type": "boolean"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"observationCounts": {
"additionalProperties": false,
"properties": {
"concernOrReview": {
"minimum": 0,
"type": "integer"
},
"notObserved": {
"minimum": 0,
"type": "integer"
},
"observedPositive": {
"minimum": 0,
"type": "integer"
},
"total": {
"minimum": 0,
"type": "integer"
},
"unavailable": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"total",
"observedPositive",
"concernOrReview",
"notObserved",
"unavailable"
],
"type": "object"
},
"observations": {
"items": {
"additionalProperties": false,
"properties": {
"assessmentStatus": {
"enum": [
"gap_observed",
"review_signal",
"checked",
"coverage_limitation",
"not_applicable"
],
"type": "string"
},
"evidenceRefs": {
"items": {
"type": "string"
},
"type": "array"
},
"evidenceState": {
"enum": [
"observed",
"not_observed",
"not_testable",
"not_applicable"
],
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"status": {
"enum": [
"Gap observed",
"Observed",
"Not confirmed",
"Not observed",
"Not testable",
"Review signal",
"Insufficient evidence",
"Out of scope"
],
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"id",
"label",
"status",
"assessmentStatus",
"evidenceState",
"summary",
"evidenceRefs"
],
"type": "object"
},
"type": "array"
},
"retainedSummary": {
"additionalProperties": {},
"type": "object"
},
"status": {
"enum": [
"available",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"status",
"evidenceRetained",
"observationCounts",
"observations",
"limitations"
],
"type": "object"
},
"type": {
"enum": [
"certscore_pulse",
"certscore_pulse_summary",
"certscore_pulse_evidence"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"gpcResponse": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"activityComparison": {
"additionalProperties": false,
"properties": {
"activity": {
"additionalProperties": false,
"properties": {
"advertisingMarketing": {
"additionalProperties": false,
"properties": {
"baselineRequests": {
"maximum": 5000,
"minimum": 0,
"type": "integer"
},
"baselineServices": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
},
"gpcRequests": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
},
"gpcServices": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
}
},
"required": [
"baselineRequests",
"gpcRequests",
"baselineServices",
"gpcServices"
],
"type": "object"
},
"analyticsReplay": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing"
}
},
"required": [
"advertisingMarketing",
"analyticsReplay"
],
"type": "object"
},
"causedByGpc": {
"const": "not_established",
"type": "string"
},
"contractVersion": {
"const": "certscore.gpc-activity-comparison.v1",
"type": "string"
},
"durationMs": {
"enum": [
250,
500,
1000
],
"type": "number"
},
"scanId": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"scope": {
"const": "matched_post_commit_request_window",
"type": "string"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"sourceHashes": {
"additionalProperties": false,
"properties": {
"baseline": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"gpc": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"baseline",
"gpc"
],
"type": "object"
},
"status": {
"const": "measured",
"type": "string"
}
},
"required": [
"contractVersion",
"scanId",
"status",
"scope",
"durationMs",
"sourceHashes",
"activity",
"scoreEffect",
"causedByGpc"
],
"type": "object"
},
"californiaPolicy": {
"additionalProperties": false,
"properties": {
"applied": {
"type": "boolean"
},
"deductionPoints": {
"enum": [
0,
15
],
"type": "number"
}
},
"required": [
"applied",
"deductionPoints"
],
"type": "object"
},
"comparison": {
"additionalProperties": false,
"properties": {
"baselineArtifact": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"lane": {
"const": "runtime_evidence",
"type": "string"
},
"sha256": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"sizeBytes": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"lane",
"sha256",
"sizeBytes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"comparable": {
"type": "boolean"
},
"coverage": {
"additionalProperties": false,
"properties": {
"comparedThroughMs": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"complete",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"status",
"comparedThroughMs"
],
"type": "object"
},
"delivery": {
"additionalProperties": false,
"properties": {
"status": {
"enum": [
"verified",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"deltas": {
"additionalProperties": false,
"properties": {
"advertisingOrMarketingActivity": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"advertisingOrMeasurementActivity": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"consentOrCmpBehavior": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"cookies": {
"additionalProperties": false,
"properties": {
"baselineCount": {
"minimum": 0,
"type": "integer"
},
"baselineOnly": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"baselineOnlyCount": {
"minimum": 0,
"type": "integer"
},
"countDelta": {
"type": "integer"
},
"gpcCount": {
"minimum": 0,
"type": "integer"
},
"gpcOnly": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"gpcOnlyCount": {
"minimum": 0,
"type": "integer"
},
"samplesTruncated": {
"type": "boolean"
},
"shared": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"sharedCount": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"baselineCount",
"gpcCount",
"countDelta",
"baselineOnly",
"gpcOnly",
"shared"
],
"type": "object"
},
"trackers": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"webStorage": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
}
},
"required": [
"cookies",
"trackers",
"advertisingOrMeasurementActivity",
"consentOrCmpBehavior"
],
"type": "object"
},
"enabledProof": {
"additionalProperties": false,
"properties": {
"navigatorGlobalPrivacyControl": {
"type": [
"boolean",
"null"
]
},
"requestEventIds": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"requestsWithSecGpc": {
"minimum": 0,
"type": "integer"
},
"secGpcHeaderValue": {
"anyOf": [
{
"const": "1",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"secGpcHeaderValue",
"requestsWithSecGpc",
"requestEventIds",
"navigatorGlobalPrivacyControl"
],
"type": "object"
},
"gpcArtifact": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"lane": {
"const": "gpc_observation",
"type": "string"
},
"sha256": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"sizeBytes": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"lane",
"sha256",
"sizeBytes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"limitationKeys": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"protocol": {
"const": "passive_baseline_with_sec_gpc",
"type": "string"
},
"responseBasis": {
"enum": [
"qualified_activity_reduction",
"no_qualified_reduction",
"insufficient_evidence"
],
"type": "string"
}
},
"required": [
"comparable",
"protocol",
"baselineArtifact",
"gpcArtifact",
"enabledProof",
"deltas",
"limitationKeys"
],
"type": "object"
},
"contractVersion": {
"enum": [
"certscore.gpc-response-assessment.v1",
"certscore.gpc-response-assessment.v2",
"certscore.gpc-response-assessment.v3"
],
"type": "string"
},
"evidenceUrl": {
"format": "uri",
"type": "string"
},
"findingTitle": {
"enum": [
"GPC response",
"No observable GPC response"
],
"type": "string"
},
"legalInterpretation": {
"const": "not_assessed",
"type": "string"
},
"observation": {
"additionalProperties": false,
"properties": {
"acknowledgment": {
"additionalProperties": false,
"properties": {
"captureComplete": {
"type": "boolean"
},
"observed": {
"type": "boolean"
}
},
"required": [
"observed",
"captureComplete"
],
"type": "object"
},
"contractVersion": {
"const": "certscore.gpc-bounded-observation.v1",
"type": "string"
},
"delivery": {
"additionalProperties": false,
"properties": {
"fullContextVerified": {
"type": "boolean"
},
"httpHeaderRetained": {
"type": "boolean"
},
"mainNavigatorReadbackRetained": {
"type": "boolean"
}
},
"required": [
"httpHeaderRetained",
"mainNavigatorReadbackRetained",
"fullContextVerified"
],
"type": "object"
},
"documentUrlSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"legalInterpretation": {
"const": "not_assessed",
"type": "string"
},
"limitationKeys": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 32,
"type": "array"
},
"registration": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "current_recorded_state",
"type": "string"
},
"causedByGpc": {
"const": "not_established",
"type": "string"
},
"cmpGpcSignal": {
"enum": [
"received",
"not_received",
"unknown"
],
"type": "string"
},
"sale": {
"enum": [
"opted_out",
"not_opted_out",
"unknown"
],
"type": "string"
},
"sharing": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/registration/properties/sale"
}
},
"required": [
"basis",
"sale",
"sharing",
"cmpGpcSignal",
"causedByGpc"
],
"type": "object"
},
"requests": {
"additionalProperties": false,
"properties": {
"blockedBeforeTransmissionCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"classifiedCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"collectionCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"complete": {
"type": "boolean"
},
"count": {
"minimum": 0,
"type": "integer"
},
"documentCommittedAtMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
},
"evidenceIds": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"fromMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
},
"samplesTruncated": {
"type": "boolean"
},
"throughMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
}
},
"required": [
"count",
"blockedBeforeTransmissionCount",
"complete",
"fromMs",
"documentCommittedAtMs",
"throughMs",
"classifiedCount",
"collectionCount",
"evidenceIds",
"samplesTruncated"
],
"type": "object"
},
"scope": {
"const": "main_document_and_retained_http_requests",
"type": "string"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"semanticProbe": {
"enum": [
"observed",
"unsupported",
"unavailable",
"not_ready",
"invalid",
"incomplete"
],
"type": "string"
},
"sessionSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"sourceSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"complete",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"contractVersion",
"scope",
"status",
"sourceSha256",
"sessionSha256",
"documentUrlSha256",
"delivery",
"semanticProbe",
"registration",
"acknowledgment",
"requests",
"limitationKeys",
"scoreEffect",
"legalInterpretation"
],
"type": "object"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"status": {
"enum": [
"responsive",
"no_observable_response",
"indeterminate"
],
"type": "string"
},
"summary": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"status",
"findingTitle",
"summary",
"scoreEffect",
"legalInterpretation",
"comparison",
"californiaPolicy",
"evidenceUrl"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"interpretationGuidance": {
"additionalProperties": false,
"properties": {
"doNotInferLegalComplianceStatus": {
"const": true,
"type": "boolean"
},
"doNotInferUnobservedTechnologies": {
"const": true,
"type": "boolean"
},
"observableSignalsOnly": {
"const": true,
"type": "boolean"
},
"scoreLabel": {
"const": "CertScore score",
"type": "string"
},
"statement": {
"type": "string"
}
},
"required": [
"scoreLabel",
"observableSignalsOnly",
"doNotInferUnobservedTechnologies",
"doNotInferLegalComplianceStatus",
"statement"
],
"type": "object"
},
"links": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"mcpMetadata": {
"additionalProperties": false,
"properties": {
"actualBytes": {
"minimum": 0,
"type": "integer"
},
"canonicalFindingsComplete": {
"type": "boolean"
},
"contentUrls": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"deduplicatedSections": {
"items": {
"type": "string"
},
"type": "array"
},
"detail": {
"enum": [
"summary",
"findings",
"evidence",
"full"
],
"type": "string"
},
"effectiveMaxBytes": {
"maximum": 200000,
"minimum": 5000,
"type": "integer"
},
"findingsTruncated": {
"type": "boolean"
},
"fullPayloadBytes": {
"minimum": 0,
"type": "integer"
},
"heavyEvidenceIncluded": {
"type": "boolean"
},
"nextRecommendedMaxBytes": {
"anyOf": [
{
"maximum": 200000,
"minimum": 5000,
"type": "integer"
},
{
"type": "null"
}
]
},
"omittedContentAvailableViaUrl": {
"type": "boolean"
},
"omittedSections": {
"items": {
"type": "string"
},
"type": "array"
},
"requestedMaxBytes": {
"minimum": 5000,
"type": "integer"
},
"responseBudgetClamped": {
"type": "boolean"
},
"responseCeilingBytes": {
"maximum": 200000,
"minimum": 5000,
"type": "integer"
},
"truncated": {
"type": "boolean"
},
"truncationReason": {
"type": [
"string",
"null"
]
}
},
"required": [
"detail",
"heavyEvidenceIncluded",
"findingsTruncated",
"requestedMaxBytes",
"effectiveMaxBytes",
"responseCeilingBytes",
"responseBudgetClamped",
"actualBytes",
"fullPayloadBytes",
"truncated",
"canonicalFindingsComplete",
"truncationReason",
"omittedSections",
"deduplicatedSections",
"nextRecommendedMaxBytes",
"omittedContentAvailableViaUrl",
"contentUrls"
],
"type": "object"
},
"noGo": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"evidenceExcerpt": {
"maxLength": 360,
"type": "string"
},
"explanation": {
"type": "string"
},
"limitationKind": {
"enum": [
"target_site_state",
"scanner_access_limitation",
"scanner_capture_limitation"
],
"type": "string"
},
"reasonCode": {
"enum": [
"blank_or_unusable_page",
"loading_or_stalled",
"not_found_404",
"parked_or_placeholder",
"site_not_ready",
"captcha_or_challenge",
"access_denied_or_forbidden_page",
"authentication_required",
"rate_limited_429",
"server_error_5xx",
"configuration_error",
"maintenance_or_unavailable",
"tls_or_certificate_error",
"unsupported_region",
"target_unreachable_or_unsuitable",
"navigation_transport_failure",
"visual_capture_failed_or_placeholder",
"retained_visual_error_shell",
"unknown"
],
"type": "string"
},
"recommendedNextAction": {
"type": "string"
},
"retryLikelyToHelp": {
"type": "boolean"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"reasonCode",
"title",
"explanation",
"summary",
"limitationKind",
"recommendedNextAction",
"retryLikelyToHelp"
],
"type": "object"
},
{
"type": "null"
}
]
},
"observationOnlyDisclaimer": {
"type": "string"
},
"postAcceptObservation": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"acceptanceExercised": {
"type": "boolean"
},
"afterAction": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"accept",
"reject"
],
"type": "string"
},
"activationStatus": {
"enum": [
"completed",
"uncertain"
],
"type": "string"
},
"policyVersion": {
"enum": [
"bounded_after_action_capture.v1",
"bounded_after_action_capture.v2"
],
"type": "string"
},
"requestCount": {
"minimum": 0,
"type": "integer"
},
"requestsDropped": {
"minimum": 0,
"type": "integer"
},
"stopReason": {
"enum": [
"window_elapsed",
"aborted",
"target_changed",
"click_uncertain"
],
"type": "string"
},
"storageSnapshotRetained": {
"type": "boolean"
},
"storageWriteCount": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"policyVersion",
"action",
"activationStatus",
"stopReason",
"requestsDropped",
"requestCount",
"storageWriteCount",
"storageSnapshotRetained"
],
"type": "object"
},
"completedAt": {
"type": [
"string",
"null"
]
},
"coverageLimitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"evidenceDisposition": {
"enum": [
"confirmed",
"indeterminate"
],
"type": "string"
},
"execution": {
"additionalProperties": false,
"properties": {
"clickCompleted": {
"type": "boolean"
},
"consentConfirmed": {
"type": "boolean"
},
"observationCompleted": {
"type": "boolean"
},
"policyVersion": {
"const": "choice_path_execution.v1",
"type": "string"
},
"status": {
"enum": [
"succeeded",
"succeeded_with_confirmation",
"limited",
"not_attempted",
"unsupported"
],
"type": "string"
}
},
"required": [
"policyVersion",
"status",
"clickCompleted",
"observationCompleted",
"consentConfirmed"
],
"type": "object"
},
"indeterminateReason": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"interpretation": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"observationCount": {
"minimum": 0,
"type": "integer"
},
"observationStrategy": {
"enum": [
"stop_on_first_eligible_activity",
"not_applicable"
],
"type": "string"
},
"productionProjectable": {
"type": "boolean"
},
"status": {
"enum": [
"confirmed_observation",
"confirmed_clean",
"unconfirmed",
"not_attempted",
"unsupported",
"aborted"
],
"type": "string"
},
"termination": {
"additionalProperties": false,
"properties": {
"intentional": {
"type": "boolean"
},
"kind": {
"enum": [
"evidence_satisfied",
"window_elapsed",
"unavailable"
],
"type": "string"
},
"trigger": {
"enum": [
"non_essential_request_observed",
"non_essential_storage_write_observed",
"acceptance_signal_contradiction_observed",
"window_elapsed",
"accept_control_not_observed",
"accept_path_timeout",
"accept_observation_window_truncated",
"worker_failed",
"unavailable"
],
"type": "string"
}
},
"required": [
"kind",
"intentional",
"trigger"
],
"type": "object"
},
"verdict": {
"enum": [
"eligible_nonessential_activity_observed_after_confirmed_acceptance",
"retained_consent_signal_contradiction_observed_after_confirmed_acceptance",
"no_eligible_nonessential_activity_observed_during_completed_window",
"no_confirmed_post_accept_verdict"
],
"type": "string"
}
},
"required": [
"status",
"acceptanceExercised",
"observationCount",
"productionProjectable",
"evidenceDisposition",
"indeterminateReason",
"verdict",
"interpretation",
"observationStrategy",
"termination",
"completedAt",
"coverageLimitations",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"postRefusalObservation": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"afterAction": {
"$ref": "#/properties/postAcceptObservation/anyOf/0/anyOf/1/anyOf/0/properties/afterAction"
},
"completedAt": {
"type": [
"string",
"null"
]
},
"coverageLimitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"evidenceDisposition": {
"enum": [
"confirmed",
"indeterminate"
],
"type": "string"
},
"execution": {
"$ref": "#/properties/postAcceptObservation/anyOf/0/anyOf/1/anyOf/0/properties/execution"
},
"indeterminateReason": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"interpretation": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"observationCount": {
"minimum": 0,
"type": "integer"
},
"observationStrategy": {
"enum": [
"stop_on_first_eligible_activity",
"not_applicable"
],
"type": "string"
},
"productionProjectable": {
"type": "boolean"
},
"refusalExercised": {
"type": "boolean"
},
"status": {
"enum": [
"confirmed_observation",
"confirmed_clean",
"unconfirmed",
"not_attempted",
"unsupported",
"aborted"
],
"type": "string"
},
"termination": {
"additionalProperties": false,
"properties": {
"intentional": {
"type": "boolean"
},
"kind": {
"enum": [
"evidence_satisfied",
"window_elapsed",
"unavailable"
],
"type": "string"
},
"trigger": {
"enum": [
"non_essential_request_observed",
"non_essential_storage_write_observed",
"refusal_signal_contradiction_observed",
"window_elapsed",
"reject_path_timeout",
"worker_failed",
"unavailable"
],
"type": "string"
}
},
"required": [
"kind",
"intentional",
"trigger"
],
"type": "object"
},
"verdict": {
"enum": [
"eligible_nonessential_activity_observed_after_confirmed_refusal",
"retained_consent_signal_contradiction_observed_after_confirmed_refusal",
"no_eligible_nonessential_activity_observed_during_completed_window",
"no_confirmed_post_refusal_verdict"
],
"type": "string"
}
},
"required": [
"status",
"refusalExercised",
"observationCount",
"productionProjectable",
"evidenceDisposition",
"indeterminateReason",
"verdict",
"interpretation",
"observationStrategy",
"termination",
"completedAt",
"coverageLimitations",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"preConsentCookiesTrackers": {
"additionalProperties": false,
"properties": {
"returned": {
"minimum": 0,
"type": "integer"
},
"rows": {
"items": {
"additionalProperties": false,
"properties": {
"category": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"high",
"medium",
"low",
"unknown"
],
"type": "string"
},
"cookieNames": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"domains": {
"items": {
"maxLength": 253,
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"evidenceClassification": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "public_report_projection",
"type": "string"
},
"observedBeforeConsent": {
"type": "boolean"
},
"party": {
"enum": [
"first_party",
"third_party",
"mixed",
"unknown"
],
"type": "string"
},
"phase": {
"const": "pre_consent",
"type": "string"
},
"priority": {
"enum": [
"high",
"medium",
"review_needed",
"contextual",
"unknown"
],
"type": "string"
}
},
"required": [
"basis",
"phase",
"observedBeforeConsent",
"party",
"priority"
],
"type": "object"
},
"firstObservedAtMs": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"id": {
"maxLength": 512,
"type": "string"
},
"kind": {
"enum": [
"cookie",
"tracker",
"request",
"storage",
"unknown"
],
"type": "string"
},
"name": {
"maxLength": 256,
"type": "string"
},
"purpose": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
]
},
"requestCount": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"vendor": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"kind",
"name",
"cookieNames",
"vendor",
"purpose",
"category",
"confidence",
"firstObservedAtMs",
"domains",
"requestCount",
"evidenceClassification"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"summary": {
"additionalProperties": false,
"properties": {
"cookieCount": {
"minimum": 0,
"type": "integer"
},
"domainCount": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"requestCount": {
"minimum": 0,
"type": "integer"
},
"rowCount": {
"minimum": 0,
"type": "integer"
},
"storageCount": {
"minimum": 0,
"type": "integer"
},
"trackerCategoryCounts": {
"additionalProperties": false,
"properties": {
"advertising": {
"minimum": 0,
"type": "integer"
},
"analytics": {
"minimum": 0,
"type": "integer"
},
"essential": {
"minimum": 0,
"type": "integer"
},
"functional": {
"minimum": 0,
"type": "integer"
},
"review": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"advertising",
"analytics",
"essential",
"functional",
"review"
],
"type": "object"
},
"trackerCount": {
"minimum": 0,
"type": "integer"
},
"trackerCountScope": {
"const": "canonical_inventory_rows_including_operational",
"type": "string"
},
"vendorCount": {
"default": 0,
"minimum": 0,
"type": "integer"
}
},
"required": [
"rowCount",
"trackerCount",
"cookieCount",
"requestCount"
],
"type": "object"
},
"total": {
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"summary",
"rows",
"total",
"returned",
"truncated"
],
"type": "object"
},
"privacyAuditEvidence": {
"anyOf": [
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"capturedAt": {
"$ref": "#/properties/privacyAuditSummary/properties/capturedAt"
},
"collectionPointNoticeAssessment": {
"$ref": "#/properties/privacyAuditSummary/properties/collectionPointNoticeAssessment"
},
"contractVersion": {
"const": "certscore.privacy-audit-evidence.v1",
"type": "string"
},
"controls": {
"items": {
"$ref": "#/properties/privacyAuditSummary/properties/controls/items"
},
"maxItems": 12,
"type": "array"
},
"documentUrl": {
"$ref": "#/properties/privacyAuditSummary/properties/controls/items/properties/sourceUrl"
},
"negativeControlCoverage": {
"$ref": "#/properties/privacyAuditSummary/properties/negativeControlCoverage"
},
"notices": {
"items": {
"additionalProperties": false,
"properties": {
"coverage": {
"$ref": "#/properties/privacyAuditSummary/properties/notices/items/properties/coverage"
},
"directlyLinkedFromScannedPage": {
"$ref": "#/properties/privacyAuditSummary/properties/notices/items/properties/directlyLinkedFromScannedPage"
},
"evidenceRef": {
"$ref": "#/properties/privacyAuditSummary/properties/notices/items/properties/evidenceRef"
},
"kind": {
"$ref": "#/properties/privacyAuditSummary/properties/notices/items/properties/kind"
},
"passages": {
"items": {
"additionalProperties": false,
"properties": {
"excerpt": {
"maxLength": 480,
"minLength": 1,
"type": "string"
},
"topic": {
"$ref": "#/properties/privacyAuditSummary/properties/notices/items/properties/topics/items"
}
},
"required": [
"topic",
"excerpt"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"url": {
"$ref": "#/properties/privacyAuditSummary/properties/controls/items/properties/sourceUrl"
}
},
"required": [
"kind",
"url",
"evidenceRef",
"directlyLinkedFromScannedPage",
"coverage",
"passages"
],
"type": "object"
},
"maxItems": 4,
"type": "array"
},
"passagePolicy": {
"const": "california_notice_passages.v1",
"type": "string"
},
"scanId": {
"$ref": "#/properties/privacyAuditSummary/properties/scanId"
},
"scoreEffect": {
"$ref": "#/properties/privacyAuditSummary/properties/scoreEffect"
},
"sourceHash": {
"$ref": "#/properties/privacyAuditSummary/properties/sourceHash"
},
"truncated": {
"type": "boolean"
},
"verificationStatus": {
"$ref": "#/properties/privacyAuditSummary/properties/verificationStatus"
}
},
"required": [
"scanId",
"documentUrl",
"capturedAt",
"sourceHash",
"verificationStatus",
"scoreEffect",
"passagePolicy",
"controls",
"notices",
"negativeControlCoverage",
"collectionPointNoticeAssessment",
"truncated",
"contractVersion"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"capturedAt": {
"$ref": "#/properties/privacyAuditSummary/properties/capturedAt"
},
"collectionPointNoticeAssessment": {
"$ref": "#/properties/privacyAuditSummary/properties/collectionPointNoticeAssessment"
},
"contractVersion": {
"const": "certscore.privacy-audit-evidence.v2",
"type": "string"
},
"controlCandidates": {
"items": {
"$ref": "#/properties/privacyAuditSummary/properties/controlCandidates/items"
},
"maxItems": 12,
"type": "array"
},
"controls": {
"$ref": "#/properties/privacyAuditEvidence/anyOf/0/anyOf/0/properties/controls"
},
"documentUrl": {
"$ref": "#/properties/privacyAuditSummary/properties/controls/items/properties/sourceUrl"
},
"negativeControlCoverage": {
"$ref": "#/properties/privacyAuditSummary/properties/negativeControlCoverage"
},
"notices": {
"$ref": "#/properties/privacyAuditEvidence/anyOf/0/anyOf/0/properties/notices"
},
"passagePolicy": {
"$ref": "#/properties/privacyAuditEvidence/anyOf/0/anyOf/0/properties/passagePolicy"
},
"scanId": {
"$ref": "#/properties/privacyAuditSummary/properties/scanId"
},
"scoreEffect": {
"$ref": "#/properties/privacyAuditSummary/properties/scoreEffect"
},
"sourceHash": {
"$ref": "#/properties/privacyAuditSummary/properties/sourceHash"
},
"truncated": {
"$ref": "#/properties/privacyAuditEvidence/anyOf/0/anyOf/0/properties/truncated"
},
"verificationStatus": {
"$ref": "#/properties/privacyAuditSummary/properties/verificationStatus"
}
},
"required": [
"scanId",
"documentUrl",
"capturedAt",
"sourceHash",
"verificationStatus",
"scoreEffect",
"passagePolicy",
"controls",
"notices",
"negativeControlCoverage",
"collectionPointNoticeAssessment",
"truncated",
"contractVersion",
"controlCandidates"
],
"type": "object"
}
]
},
{
"type": "null"
}
]
},
"privacyAuditSummary": {
"additionalProperties": false,
"properties": {
"capturedAt": {
"format": "date-time",
"type": "string"
},
"collectionPointNoticeAssessment": {
"const": "not_assessed",
"type": "string"
},
"contractVersion": {
"enum": [
"certscore.privacy-audit-evidence.v1",
"certscore.privacy-audit-evidence.v2"
],
"type": "string"
},
"controlCandidates": {
"items": {
"additionalProperties": false,
"properties": {
"destinationUrl": {
"$ref": "#/properties/privacyAuditSummary/properties/controls/items/properties/sourceUrl"
},
"evidenceRef": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"kind": {
"$ref": "#/properties/privacyAuditSummary/properties/controls/items/properties/kind"
},
"label": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"placement": {
"maxLength": 80,
"type": "string"
},
"sourceUrl": {
"$ref": "#/properties/privacyAuditSummary/properties/controls/items/properties/sourceUrl"
},
"verification": {
"enum": [
"visibility_unverified",
"accessible_name_unverified"
],
"type": "string"
}
},
"required": [
"kind",
"label",
"sourceUrl",
"destinationUrl",
"placement",
"evidenceRef",
"verification"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"controls": {
"items": {
"additionalProperties": false,
"properties": {
"accessibleNameSource": {
"enum": [
"aria_label",
"aria_labelledby",
"text",
"image_alt",
"svg_title",
"title"
],
"type": "string"
},
"classificationProvenance": {
"const": "privacy_surface_classifier.v1",
"type": "string"
},
"destinationUrl": {
"anyOf": [
{
"$ref": "#/properties/privacyAuditSummary/properties/controls/items/properties/sourceUrl"
},
{
"type": "null"
}
]
},
"evidenceRef": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"interaction": {
"const": "not_tested",
"type": "string"
},
"kind": {
"enum": [
"do_not_sell_or_share",
"your_privacy_choices",
"cookie_settings"
],
"type": "string"
},
"label": {
"maxLength": 200,
"type": "string"
},
"placement": {
"maxLength": 80,
"type": "string"
},
"retrieval": {
"enum": [
"not_attempted",
"fetched",
"failed",
"skipped_budget"
],
"type": "string"
},
"sourceUrl": {
"format": "uri",
"maxLength": 800,
"type": "string"
}
},
"required": [
"kind",
"label",
"sourceUrl",
"destinationUrl",
"placement",
"evidenceRef",
"retrieval",
"interaction"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"negativeControlCoverage": {
"const": "not_verified",
"type": "string"
},
"notices": {
"items": {
"additionalProperties": false,
"properties": {
"coverage": {
"enum": [
"complete",
"partial"
],
"type": "string"
},
"directlyLinkedFromScannedPage": {
"type": "boolean"
},
"evidenceRef": {
"maxLength": 240,
"minLength": 1,
"type": "string"
},
"kind": {
"enum": [
"privacy_policy",
"california_notice",
"notice_at_collection"
],
"type": "string"
},
"topics": {
"items": {
"enum": [
"sale_sharing",
"collection_purposes",
"retention",
"privacy_rights",
"opt_out_methods"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"url": {
"$ref": "#/properties/privacyAuditSummary/properties/controls/items/properties/sourceUrl"
}
},
"required": [
"kind",
"url",
"evidenceRef",
"directlyLinkedFromScannedPage",
"coverage",
"topics"
],
"type": "object"
},
"maxItems": 2,
"type": "array"
},
"retainedControlCount": {
"minimum": 0,
"type": "integer"
},
"retainedNoticeCount": {
"minimum": 0,
"type": "integer"
},
"scanId": {
"minLength": 1,
"type": "string"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"sourceHash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"truncated": {
"type": "boolean"
},
"verificationStatus": {
"const": "verified",
"type": "string"
}
},
"required": [
"scanId",
"capturedAt",
"sourceHash",
"verificationStatus",
"scoreEffect",
"negativeControlCoverage",
"collectionPointNoticeAssessment",
"contractVersion",
"retainedControlCount",
"retainedNoticeCount",
"controls",
"notices",
"truncated"
],
"type": "object"
},
"provenance": {
"additionalProperties": false,
"properties": {
"creationDecision": {
"enum": [
"new_scan",
"reused_scan",
"unknown"
],
"type": "string"
},
"executionMode": {
"anyOf": [
{
"enum": [
"new_scan",
"reused_scan"
],
"type": "string"
},
{
"type": "null"
}
]
},
"freshnessDecision": {
"type": [
"string",
"null"
]
},
"mode": {
"enum": [
"new_scan_started",
"existing_completed_scan_reused",
"existing_scan_retrieved",
"unknown"
],
"type": "string"
},
"retrievalMode": {
"enum": [
"creation_response",
"scan_id_lookup",
"unknown"
],
"type": "string"
},
"reused": {
"type": [
"boolean",
"null"
]
},
"scanAgeSeconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"mode",
"retrievalMode",
"creationDecision",
"scanAgeSeconds",
"executionMode",
"reused",
"freshnessDecision"
],
"type": "object"
},
"recommendedNextAction": {
"type": "string"
},
"recommendedNextTool": {
"anyOf": [
{
"enum": [
"certscore_get_scan_status",
"certscore_get_scan_bundle"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportUrl": {
"type": [
"string",
"null"
]
},
"resultDisposition": {
"anyOf": [
{
"enum": [
"no_go"
],
"type": "string"
},
{
"type": "null"
}
]
},
"riskLevel": {
"type": [
"string",
"null"
]
},
"scanFrom": {
"anyOf": [
{
"enum": [
"eu_de",
"eu_ie",
"california"
],
"type": "string"
},
{
"type": "null"
}
]
},
"scanId": {
"type": "string"
},
"scanTimeSeconds": {
"type": [
"number",
"null"
]
},
"score": {
"anyOf": [
{
"maximum": 100,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"scoreLabel": {
"const": "CertScore score",
"type": "string"
},
"scoreStatus": {
"enum": [
"provisional",
"final"
],
"type": "string"
},
"scoreUpdatedAt": {
"type": [
"string",
"null"
]
},
"scoreVersion": {
"type": [
"string",
"null"
]
},
"startedAt": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"queued",
"running",
"finalizing",
"completed",
"completed_limited",
"failed",
"expired",
"rate_limited"
],
"type": "string"
},
"summary": {
"additionalProperties": false,
"properties": {
"agentInterpretation": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"doNotCallThis": {
"items": {
"enum": [
"legal_advice",
"certification",
"compliance_determination"
],
"type": "string"
},
"type": "array"
},
"requiresHumanReview": {
"const": true,
"type": "boolean"
},
"responseClass": {
"enum": [
"completed_pulse",
"pending_pulse",
"api_error",
"rate_limited"
],
"type": "string"
},
"safeSummaryUse": {
"type": "boolean"
}
},
"required": [
"responseClass",
"safeSummaryUse",
"requiresHumanReview",
"doNotCallThis"
],
"type": "object"
},
{
"type": "null"
}
]
},
"counts": {
"anyOf": [
{
"additionalProperties": {
"type": [
"number",
"boolean",
"null"
]
},
"type": "object"
},
{
"type": "null"
}
]
},
"executiveSummary": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"actionLabel": {
"type": "string"
},
"completionSummary": {
"type": "string"
},
"domain": {
"type": "string"
},
"issuesToReview": {
"minimum": 0,
"type": "integer"
},
"riskLevel": {
"type": "string"
},
"scanTimeSeconds": {
"type": [
"number",
"null"
]
},
"score": {
"anyOf": [
{
"maximum": 100,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"scoreLabel": {
"type": "string"
},
"scoreMetadata": {
"additionalProperties": true,
"properties": {
"coverageConfidence": {
"type": "string"
},
"coverageRatio": {
"type": [
"number",
"null"
]
},
"kind": {
"type": "string"
},
"metricLabel": {
"type": "string"
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
]
},
"withholdingReason": {
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"headline": {
"type": [
"string",
"null"
]
}
},
"required": [
"headline",
"executiveSummary",
"counts",
"agentInterpretation"
],
"type": "object"
},
"timing": {
"additionalProperties": false,
"properties": {
"completedAt": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": [
"string",
"null"
]
},
"scanTimeSeconds": {
"type": [
"number",
"null"
]
},
"startedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"createdAt",
"startedAt",
"completedAt",
"scanTimeSeconds"
],
"type": "object"
},
"transportSecurity": {
"$ref": "#/properties/fullReport/properties/transportSecurity"
},
"type": {
"const": "certscore_scan_bundle",
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"type",
"detail",
"scanId",
"domain",
"url",
"scanFrom",
"status",
"score",
"scoreLabel",
"scoreStatus",
"scoreVersion",
"scoreUpdatedAt",
"riskLevel",
"provenance",
"interpretationGuidance",
"createdAt",
"startedAt",
"completedAt",
"scanTimeSeconds",
"findings",
"findingsMetadata",
"transportSecurity",
"reportUrl",
"recommendedNextTool",
"recommendedNextAction",
"error",
"mcpMetadata",
"observationOnlyDisclaimer",
"disclaimer"
],
"type": "object"
}
},
{
"description": "Returns lifecycle status for a stable CertScore scanId. Active responses include phase, heartbeat, estimated progress, retryAfterSeconds, and sometimes a bounded preliminary preConsentPreview. Terminal responses include completion status, CertScore score and risk metadata when available, coverage, persisted execution region and timestamps, report URL, and a next-action field. Preliminary observations are distinct from completed findings.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"scanId": {
"description": "Stable CertScore scan ID returned by certscore_scan_site.",
"minLength": 1,
"type": "string"
}
},
"required": [
"scanId"
],
"type": "object"
},
"name": "certscore_get_scan_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"completedAt": {
"type": [
"string",
"null"
]
},
"coverage": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"additionalProperties": true,
"properties": {
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"type": "object"
}
]
},
{
"type": "null"
}
]
},
"createdAt": {
"type": [
"string",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"issues": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 80,
"type": "string"
},
"field": {
"maxLength": 80,
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"field",
"code"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"mcpCode": {
"type": "integer"
},
"message": {
"type": "string"
},
"name": {
"type": "string"
},
"recommendedNextAction": {
"type": "string"
},
"responseBody": {},
"retryAfterSeconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
},
"status": {
"type": "integer"
}
},
"required": [
"code",
"message",
"retryable",
"retryAfterSeconds",
"recommendedNextAction"
],
"type": "object"
},
{
"type": "null"
}
]
},
"estimatedRemainingSeconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"gpcResponse": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"activityComparison": {
"additionalProperties": false,
"properties": {
"activity": {
"additionalProperties": false,
"properties": {
"advertisingMarketing": {
"additionalProperties": false,
"properties": {
"baselineRequests": {
"maximum": 5000,
"minimum": 0,
"type": "integer"
},
"baselineServices": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
},
"gpcRequests": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
},
"gpcServices": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
}
},
"required": [
"baselineRequests",
"gpcRequests",
"baselineServices",
"gpcServices"
],
"type": "object"
},
"analyticsReplay": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing"
}
},
"required": [
"advertisingMarketing",
"analyticsReplay"
],
"type": "object"
},
"causedByGpc": {
"const": "not_established",
"type": "string"
},
"contractVersion": {
"const": "certscore.gpc-activity-comparison.v1",
"type": "string"
},
"durationMs": {
"enum": [
250,
500,
1000
],
"type": "number"
},
"scanId": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"scope": {
"const": "matched_post_commit_request_window",
"type": "string"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"sourceHashes": {
"additionalProperties": false,
"properties": {
"baseline": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"gpc": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"baseline",
"gpc"
],
"type": "object"
},
"status": {
"const": "measured",
"type": "string"
}
},
"required": [
"contractVersion",
"scanId",
"status",
"scope",
"durationMs",
"sourceHashes",
"activity",
"scoreEffect",
"causedByGpc"
],
"type": "object"
},
"californiaPolicy": {
"additionalProperties": false,
"properties": {
"applied": {
"type": "boolean"
},
"deductionPoints": {
"enum": [
0,
15
],
"type": "number"
}
},
"required": [
"applied",
"deductionPoints"
],
"type": "object"
},
"comparison": {
"additionalProperties": false,
"properties": {
"baselineArtifact": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"lane": {
"const": "runtime_evidence",
"type": "string"
},
"sha256": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"sizeBytes": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"lane",
"sha256",
"sizeBytes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"comparable": {
"type": "boolean"
},
"coverage": {
"additionalProperties": false,
"properties": {
"comparedThroughMs": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"complete",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"status",
"comparedThroughMs"
],
"type": "object"
},
"delivery": {
"additionalProperties": false,
"properties": {
"status": {
"enum": [
"verified",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"deltas": {
"additionalProperties": false,
"properties": {
"advertisingOrMarketingActivity": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"advertisingOrMeasurementActivity": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"consentOrCmpBehavior": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"cookies": {
"additionalProperties": false,
"properties": {
"baselineCount": {
"minimum": 0,
"type": "integer"
},
"baselineOnly": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"baselineOnlyCount": {
"minimum": 0,
"type": "integer"
},
"countDelta": {
"type": "integer"
},
"gpcCount": {
"minimum": 0,
"type": "integer"
},
"gpcOnly": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"gpcOnlyCount": {
"minimum": 0,
"type": "integer"
},
"samplesTruncated": {
"type": "boolean"
},
"shared": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"sharedCount": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"baselineCount",
"gpcCount",
"countDelta",
"baselineOnly",
"gpcOnly",
"shared"
],
"type": "object"
},
"trackers": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"webStorage": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
}
},
"required": [
"cookies",
"trackers",
"advertisingOrMeasurementActivity",
"consentOrCmpBehavior"
],
"type": "object"
},
"enabledProof": {
"additionalProperties": false,
"properties": {
"navigatorGlobalPrivacyControl": {
"type": [
"boolean",
"null"
]
},
"requestEventIds": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"requestsWithSecGpc": {
"minimum": 0,
"type": "integer"
},
"secGpcHeaderValue": {
"anyOf": [
{
"const": "1",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"secGpcHeaderValue",
"requestsWithSecGpc",
"requestEventIds",
"navigatorGlobalPrivacyControl"
],
"type": "object"
},
"gpcArtifact": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"lane": {
"const": "gpc_observation",
"type": "string"
},
"sha256": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"sizeBytes": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"lane",
"sha256",
"sizeBytes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"limitationKeys": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"protocol": {
"const": "passive_baseline_with_sec_gpc",
"type": "string"
},
"responseBasis": {
"enum": [
"qualified_activity_reduction",
"no_qualified_reduction",
"insufficient_evidence"
],
"type": "string"
}
},
"required": [
"comparable",
"protocol",
"baselineArtifact",
"gpcArtifact",
"enabledProof",
"deltas",
"limitationKeys"
],
"type": "object"
},
"contractVersion": {
"enum": [
"certscore.gpc-response-assessment.v1",
"certscore.gpc-response-assessment.v2",
"certscore.gpc-response-assessment.v3"
],
"type": "string"
},
"evidenceUrl": {
"format": "uri",
"type": "string"
},
"findingTitle": {
"enum": [
"GPC response",
"No observable GPC response"
],
"type": "string"
},
"legalInterpretation": {
"const": "not_assessed",
"type": "string"
},
"observation": {
"additionalProperties": false,
"properties": {
"acknowledgment": {
"additionalProperties": false,
"properties": {
"captureComplete": {
"type": "boolean"
},
"observed": {
"type": "boolean"
}
},
"required": [
"observed",
"captureComplete"
],
"type": "object"
},
"contractVersion": {
"const": "certscore.gpc-bounded-observation.v1",
"type": "string"
},
"delivery": {
"additionalProperties": false,
"properties": {
"fullContextVerified": {
"type": "boolean"
},
"httpHeaderRetained": {
"type": "boolean"
},
"mainNavigatorReadbackRetained": {
"type": "boolean"
}
},
"required": [
"httpHeaderRetained",
"mainNavigatorReadbackRetained",
"fullContextVerified"
],
"type": "object"
},
"documentUrlSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"legalInterpretation": {
"const": "not_assessed",
"type": "string"
},
"limitationKeys": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 32,
"type": "array"
},
"registration": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "current_recorded_state",
"type": "string"
},
"causedByGpc": {
"const": "not_established",
"type": "string"
},
"cmpGpcSignal": {
"enum": [
"received",
"not_received",
"unknown"
],
"type": "string"
},
"sale": {
"enum": [
"opted_out",
"not_opted_out",
"unknown"
],
"type": "string"
},
"sharing": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/registration/properties/sale"
}
},
"required": [
"basis",
"sale",
"sharing",
"cmpGpcSignal",
"causedByGpc"
],
"type": "object"
},
"requests": {
"additionalProperties": false,
"properties": {
"blockedBeforeTransmissionCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"classifiedCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"collectionCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"complete": {
"type": "boolean"
},
"count": {
"minimum": 0,
"type": "integer"
},
"documentCommittedAtMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
},
"evidenceIds": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"fromMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
},
"samplesTruncated": {
"type": "boolean"
},
"throughMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
}
},
"required": [
"count",
"blockedBeforeTransmissionCount",
"complete",
"fromMs",
"documentCommittedAtMs",
"throughMs",
"classifiedCount",
"collectionCount",
"evidenceIds",
"samplesTruncated"
],
"type": "object"
},
"scope": {
"const": "main_document_and_retained_http_requests",
"type": "string"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"semanticProbe": {
"enum": [
"observed",
"unsupported",
"unavailable",
"not_ready",
"invalid",
"incomplete"
],
"type": "string"
},
"sessionSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"sourceSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"complete",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"contractVersion",
"scope",
"status",
"sourceSha256",
"sessionSha256",
"documentUrlSha256",
"delivery",
"semanticProbe",
"registration",
"acknowledgment",
"requests",
"limitationKeys",
"scoreEffect",
"legalInterpretation"
],
"type": "object"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"status": {
"enum": [
"responsive",
"no_observable_response",
"indeterminate"
],
"type": "string"
},
"summary": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"status",
"findingTitle",
"summary",
"scoreEffect",
"legalInterpretation",
"comparison",
"californiaPolicy",
"evidenceUrl"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"interpretationGuidance": {
"additionalProperties": false,
"properties": {
"doNotInferLegalComplianceStatus": {
"const": true,
"type": "boolean"
},
"doNotInferUnobservedTechnologies": {
"const": true,
"type": "boolean"
},
"observableSignalsOnly": {
"const": true,
"type": "boolean"
},
"scoreLabel": {
"const": "CertScore score",
"type": "string"
},
"statement": {
"type": "string"
}
},
"required": [
"scoreLabel",
"observableSignalsOnly",
"doNotInferUnobservedTechnologies",
"doNotInferLegalComplianceStatus",
"statement"
],
"type": "object"
},
"jobId": {
"type": "string"
},
"lastHeartbeatAt": {
"type": [
"string",
"null"
]
},
"lastUpdatedAt": {
"type": "string"
},
"links": {
"additionalProperties": true,
"properties": {
"docs": {
"type": "string"
},
"findings": {
"type": "string"
},
"latestDomainScan": {
"type": "string"
},
"pulse": {
"type": "string"
},
"report": {
"type": "string"
},
"self": {
"type": "string"
},
"status": {
"type": "string"
}
},
"type": "object"
},
"noGo": {
"additionalProperties": false,
"properties": {
"evidenceExcerpt": {
"maxLength": 360,
"type": "string"
},
"explanation": {
"type": "string"
},
"limitationKind": {
"enum": [
"target_site_state",
"scanner_access_limitation",
"scanner_capture_limitation"
],
"type": "string"
},
"reasonCode": {
"enum": [
"blank_or_unusable_page",
"loading_or_stalled",
"not_found_404",
"parked_or_placeholder",
"site_not_ready",
"captcha_or_challenge",
"access_denied_or_forbidden_page",
"authentication_required",
"rate_limited_429",
"server_error_5xx",
"configuration_error",
"maintenance_or_unavailable",
"tls_or_certificate_error",
"unsupported_region",
"target_unreachable_or_unsuitable",
"navigation_transport_failure",
"visual_capture_failed_or_placeholder",
"retained_visual_error_shell",
"unknown"
],
"type": "string"
},
"recommendedNextAction": {
"type": "string"
},
"retryLikelyToHelp": {
"type": "boolean"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"reasonCode",
"title",
"explanation",
"summary",
"limitationKind",
"recommendedNextAction",
"retryLikelyToHelp"
],
"type": "object"
},
"observationOnlyDisclaimer": {
"type": "string"
},
"phase": {
"type": "string"
},
"phaseStartedAt": {
"type": [
"string",
"null"
]
},
"postAcceptObservation": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"acceptanceExercised": {
"type": "boolean"
},
"afterAction": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"accept",
"reject"
],
"type": "string"
},
"activationStatus": {
"enum": [
"completed",
"uncertain"
],
"type": "string"
},
"policyVersion": {
"enum": [
"bounded_after_action_capture.v1",
"bounded_after_action_capture.v2"
],
"type": "string"
},
"requestCount": {
"minimum": 0,
"type": "integer"
},
"requestsDropped": {
"minimum": 0,
"type": "integer"
},
"stopReason": {
"enum": [
"window_elapsed",
"aborted",
"target_changed",
"click_uncertain"
],
"type": "string"
},
"storageSnapshotRetained": {
"type": "boolean"
},
"storageWriteCount": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"policyVersion",
"action",
"activationStatus",
"stopReason",
"requestsDropped",
"requestCount",
"storageWriteCount",
"storageSnapshotRetained"
],
"type": "object"
},
"completedAt": {
"type": [
"string",
"null"
]
},
"coverageLimitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"evidenceDisposition": {
"enum": [
"confirmed",
"indeterminate"
],
"type": "string"
},
"execution": {
"additionalProperties": false,
"properties": {
"clickCompleted": {
"type": "boolean"
},
"consentConfirmed": {
"type": "boolean"
},
"observationCompleted": {
"type": "boolean"
},
"policyVersion": {
"const": "choice_path_execution.v1",
"type": "string"
},
"status": {
"enum": [
"succeeded",
"succeeded_with_confirmation",
"limited",
"not_attempted",
"unsupported"
],
"type": "string"
}
},
"required": [
"policyVersion",
"status",
"clickCompleted",
"observationCompleted",
"consentConfirmed"
],
"type": "object"
},
"indeterminateReason": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"interpretation": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"observationCount": {
"minimum": 0,
"type": "integer"
},
"observationStrategy": {
"enum": [
"stop_on_first_eligible_activity",
"not_applicable"
],
"type": "string"
},
"productionProjectable": {
"type": "boolean"
},
"status": {
"enum": [
"confirmed_observation",
"confirmed_clean",
"unconfirmed",
"not_attempted",
"unsupported",
"aborted"
],
"type": "string"
},
"termination": {
"additionalProperties": false,
"properties": {
"intentional": {
"type": "boolean"
},
"kind": {
"enum": [
"evidence_satisfied",
"window_elapsed",
"unavailable"
],
"type": "string"
},
"trigger": {
"enum": [
"non_essential_request_observed",
"non_essential_storage_write_observed",
"acceptance_signal_contradiction_observed",
"window_elapsed",
"accept_control_not_observed",
"accept_path_timeout",
"accept_observation_window_truncated",
"worker_failed",
"unavailable"
],
"type": "string"
}
},
"required": [
"kind",
"intentional",
"trigger"
],
"type": "object"
},
"verdict": {
"enum": [
"eligible_nonessential_activity_observed_after_confirmed_acceptance",
"retained_consent_signal_contradiction_observed_after_confirmed_acceptance",
"no_eligible_nonessential_activity_observed_during_completed_window",
"no_confirmed_post_accept_verdict"
],
"type": "string"
}
},
"required": [
"status",
"acceptanceExercised",
"observationCount",
"productionProjectable",
"evidenceDisposition",
"indeterminateReason",
"verdict",
"interpretation",
"observationStrategy",
"termination",
"completedAt",
"coverageLimitations",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"postRefusalObservation": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"afterAction": {
"$ref": "#/properties/postAcceptObservation/anyOf/0/anyOf/1/anyOf/0/properties/afterAction"
},
"completedAt": {
"type": [
"string",
"null"
]
},
"coverageLimitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"evidenceDisposition": {
"enum": [
"confirmed",
"indeterminate"
],
"type": "string"
},
"execution": {
"$ref": "#/properties/postAcceptObservation/anyOf/0/anyOf/1/anyOf/0/properties/execution"
},
"indeterminateReason": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"interpretation": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"observationCount": {
"minimum": 0,
"type": "integer"
},
"observationStrategy": {
"enum": [
"stop_on_first_eligible_activity",
"not_applicable"
],
"type": "string"
},
"productionProjectable": {
"type": "boolean"
},
"refusalExercised": {
"type": "boolean"
},
"status": {
"enum": [
"confirmed_observation",
"confirmed_clean",
"unconfirmed",
"not_attempted",
"unsupported",
"aborted"
],
"type": "string"
},
"termination": {
"additionalProperties": false,
"properties": {
"intentional": {
"type": "boolean"
},
"kind": {
"enum": [
"evidence_satisfied",
"window_elapsed",
"unavailable"
],
"type": "string"
},
"trigger": {
"enum": [
"non_essential_request_observed",
"non_essential_storage_write_observed",
"refusal_signal_contradiction_observed",
"window_elapsed",
"reject_path_timeout",
"worker_failed",
"unavailable"
],
"type": "string"
}
},
"required": [
"kind",
"intentional",
"trigger"
],
"type": "object"
},
"verdict": {
"enum": [
"eligible_nonessential_activity_observed_after_confirmed_refusal",
"retained_consent_signal_contradiction_observed_after_confirmed_refusal",
"no_eligible_nonessential_activity_observed_during_completed_window",
"no_confirmed_post_refusal_verdict"
],
"type": "string"
}
},
"required": [
"status",
"refusalExercised",
"observationCount",
"productionProjectable",
"evidenceDisposition",
"indeterminateReason",
"verdict",
"interpretation",
"observationStrategy",
"termination",
"completedAt",
"coverageLimitations",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"preConsentPreview": {
"additionalProperties": false,
"properties": {
"cookies": {
"items": {
"additionalProperties": false,
"properties": {
"domain": {
"anyOf": [
{
"maxLength": 253,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"essentiality": {
"enum": [
"essential",
"non_essential",
"unknown"
],
"type": "string"
},
"name": {
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"observedAtMs": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"party": {
"enum": [
"first_party",
"third_party",
"unknown"
],
"type": "string"
},
"purpose": {
"enum": [
"analytics",
"advertising",
"marketing",
"personalization",
"session_replay",
"consent_management",
"tag_management",
"infrastructure",
"security",
"performance_monitoring",
"customer_support",
"unknown"
],
"type": "string"
}
},
"required": [
"name",
"domain",
"party",
"purpose",
"essentiality",
"observedAtMs"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"final": {
"const": false,
"type": "boolean"
},
"generatedAt": {
"format": "date-time",
"type": "string"
},
"mustContinuePolling": {
"const": true,
"type": "boolean"
},
"observationOnlyDisclaimer": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"operationalVendors": {
"items": {
"additionalProperties": false,
"properties": {
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"domains": {
"items": {
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"product": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"purpose": {
"enum": [
"analytics",
"advertising",
"marketing",
"personalization",
"session_replay",
"consent_management",
"tag_management",
"infrastructure",
"security",
"performance_monitoring",
"customer_support",
"unknown"
],
"type": "string"
},
"vendor": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"vendor",
"product",
"purpose",
"confidence",
"domains"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"resources": {
"items": {
"additionalProperties": false,
"properties": {
"confidence": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"domains": {
"items": {
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"kind": {
"enum": [
"request",
"embed"
],
"type": "string"
},
"observedAtMs": {
"minimum": 0,
"type": "integer"
},
"party": {
"enum": [
"first_party",
"third_party",
"mixed",
"unknown"
],
"type": "string"
},
"product": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"purpose": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"requestCount": {
"minimum": 0,
"type": "integer"
},
"vendor": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"vendor",
"product",
"purpose",
"confidence",
"domains",
"party",
"observedAtMs",
"requestCount"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"resultStage": {
"const": "preliminary",
"type": "string"
},
"runtimeCoverage": {
"additionalProperties": false,
"properties": {
"limitationKeys": {
"items": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxItems": 16,
"type": "array"
},
"status": {
"enum": [
"usable",
"limited_partial",
"limited_none",
"not_applicable"
],
"type": "string"
}
},
"required": [
"status",
"limitationKeys"
],
"type": "object"
},
"sourceLane": {
"const": "runtime_evidence",
"type": "string"
},
"summary": {
"additionalProperties": false,
"properties": {
"cookieCount": {
"minimum": 0,
"type": "integer"
},
"operationalVendorCount": {
"minimum": 0,
"type": "integer"
},
"returnedCookieCount": {
"minimum": 0,
"type": "integer"
},
"returnedOperationalVendorCount": {
"minimum": 0,
"type": "integer"
},
"returnedTrackingVendorCount": {
"minimum": 0,
"type": "integer"
},
"thirdPartyRequestCount": {
"minimum": 0,
"type": "integer"
},
"trackerCount": {
"minimum": 0,
"type": "integer"
},
"trackingVendorCount": {
"minimum": 0,
"type": "integer"
},
"vendorCount": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"cookieCount",
"trackerCount",
"thirdPartyRequestCount",
"vendorCount"
],
"type": "object"
},
"trackers": {
"items": {
"additionalProperties": false,
"properties": {
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"domains": {
"items": {
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"product": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"purpose": {
"enum": [
"analytics",
"advertising",
"marketing",
"personalization",
"session_replay",
"consent_management",
"tag_management",
"infrastructure",
"security",
"performance_monitoring",
"customer_support",
"unknown"
],
"type": "string"
},
"vendor": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"vendor",
"product",
"purpose",
"confidence",
"domains"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"truncated": {
"additionalProperties": false,
"properties": {
"cookies": {
"type": "boolean"
},
"operationalVendors": {
"type": "boolean"
},
"resources": {
"type": "boolean"
},
"trackers": {
"type": "boolean"
}
},
"required": [
"cookies",
"trackers"
],
"type": "object"
},
"type": {
"const": "certscore_pre_consent_preview",
"type": "string"
}
},
"required": [
"type",
"resultStage",
"final",
"sourceLane",
"generatedAt",
"runtimeCoverage",
"summary",
"cookies",
"trackers",
"truncated",
"mustContinuePolling",
"observationOnlyDisclaimer"
],
"type": "object"
},
"progressIsEstimate": {
"type": "boolean"
},
"progressPercent": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"provenance": {
"additionalProperties": false,
"properties": {
"creationDecision": {
"enum": [
"new_scan",
"reused_scan",
"unknown"
],
"type": "string"
},
"executionMode": {
"anyOf": [
{
"enum": [
"new_scan",
"reused_scan"
],
"type": "string"
},
{
"type": "null"
}
]
},
"freshnessDecision": {
"type": [
"string",
"null"
]
},
"mode": {
"enum": [
"new_scan_started",
"existing_completed_scan_reused",
"existing_scan_retrieved",
"unknown"
],
"type": "string"
},
"retrievalMode": {
"enum": [
"creation_response",
"scan_id_lookup",
"unknown"
],
"type": "string"
},
"reused": {
"type": [
"boolean",
"null"
]
},
"scanAgeSeconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"mode",
"retrievalMode",
"creationDecision",
"scanAgeSeconds",
"executionMode",
"reused",
"freshnessDecision"
],
"type": "object"
},
"recommendedNextAction": {
"type": "string"
},
"recommendedNextTool": {
"anyOf": [
{
"enum": [
"certscore_get_scan_status",
"certscore_get_scan_bundle"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportUrl": {
"type": [
"string",
"null"
]
},
"resultDisposition": {
"enum": [
"no_go"
],
"type": "string"
},
"retryAfterSeconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"riskLevel": {
"type": [
"string",
"null"
]
},
"scanFrom": {
"anyOf": [
{
"enum": [
"eu_de",
"eu_ie",
"california"
],
"type": "string"
},
{
"type": "null"
}
]
},
"scanId": {
"type": [
"string",
"null"
]
},
"scanTimeSeconds": {
"type": [
"number",
"null"
]
},
"scan_id": {
"type": [
"string",
"null"
]
},
"score": {
"anyOf": [
{
"maximum": 100,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"scoreLabel": {
"const": "CertScore score",
"type": "string"
},
"scoreStatus": {
"enum": [
"provisional",
"final"
],
"type": "string"
},
"scoreUpdatedAt": {
"type": [
"string",
"null"
]
},
"scoreVersion": {
"type": [
"string",
"null"
]
},
"stalled": {
"type": "boolean"
},
"startedAt": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"queued",
"running",
"finalizing",
"completed",
"completed_limited",
"failed",
"expired",
"rate_limited"
],
"type": "string"
},
"type": {
"enum": [
"certscore_scan_job",
"certscore_pulse_status"
],
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"scoreLabel",
"error",
"provenance",
"interpretationGuidance",
"recommendedNextTool",
"recommendedNextAction",
"observationOnlyDisclaimer"
],
"type": "object"
}
},
{
"description": "Creates a public-website privacy scan or reuses an eligible recent completed scan. Coverage includes pre-consent storage, trackers, consent and CMP signals, privacy-policy disclosures, transport security, and GDPR/ePrivacy or CCPA/CPRA review signals. The response contains a stable scanId, lifecycle status, retry timing, and sometimes a bounded preliminary preConsentPreview; preliminary data contains no final findings or score. Results are automated public-web observations, not legal advice, certification, or a compliance determination. Tool and workflow documentation: https://certscore.ai/developers/mcp.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"freshness": {
"description": "Scan freshness policy. latest allows eligible recent completed-result reuse when available; refresh requests a new scan. Defaults to latest.",
"enum": [
"latest",
"refresh"
],
"type": "string"
},
"maxWaitSeconds": {
"description": "Deprecated compatibility field; accepted but ignored. The bounded preliminary-preview wait is controlled by CertScore and never waits for scan completion.",
"maximum": 45,
"minimum": 1,
"type": "integer"
},
"scanFrom": {
"description": "Optional execution region for a newly queued scan: eu_de, eu_ie, california, or the service default when omitted.",
"enum": [
"eu_de",
"eu_ie",
"california"
],
"type": "string"
},
"taskContext": {
"additionalProperties": false,
"description": "Optional caller-declared purpose and integration ID/version for usage research. Only include questionSummary when the user knowingly agrees to share a brief non-sensitive question for product improvement; label user_wording or agent_paraphrase. Never include chat history, personal/account details, secrets or URLs. Omission does not affect scanning.",
"properties": {
"integrationId": {
"maxLength": 80,
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$",
"type": "string"
},
"integrationVersion": {
"$ref": "#/properties/taskContext/properties/integrationId"
},
"purpose": {
"enum": [
"prelaunch_review",
"vendor_review",
"tracking_check",
"consent_gpc_check",
"policy_review",
"recheck",
"other",
"unknown"
],
"type": "string"
},
"questionSource": {
"enum": [
"user_wording",
"agent_paraphrase"
],
"type": "string"
},
"questionSummary": {
"maxLength": 8192,
"minLength": 1,
"type": "string"
},
"shareForImprovement": {
"type": "boolean"
},
"skillVersion": {
"$ref": "#/properties/taskContext/properties/integrationId"
}
},
"type": "object"
},
"url": {
"description": "Public URL or domain to scan.",
"minLength": 1,
"type": "string"
},
"waitForCompletion": {
"description": "Deprecated compatibility field; accepted but ignored. certscore_scan_site never waits for a new scan to finish, though MCP Light may briefly wait within a bounded preview window for preliminary pre-consent observations.",
"type": "boolean"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "certscore_scan_site",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"completedAt": {
"type": [
"string",
"null"
]
},
"coverage": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"additionalProperties": true,
"properties": {
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"type": "object"
}
]
},
{
"type": "null"
}
]
},
"createdAt": {
"type": [
"string",
"null"
]
},
"demoSubstitution": {
"additionalProperties": false,
"properties": {
"effectiveUrl": {
"format": "uri",
"type": "string"
},
"message": {
"type": "string"
},
"reason": {
"const": "iana_example_domain",
"type": "string"
},
"requestedUrl": {
"type": "string"
}
},
"required": [
"requestedUrl",
"effectiveUrl",
"reason",
"message"
],
"type": "object"
},
"domain": {
"type": [
"string",
"null"
]
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"issues": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 80,
"type": "string"
},
"field": {
"maxLength": 80,
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"field",
"code"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"mcpCode": {
"type": "integer"
},
"message": {
"type": "string"
},
"name": {
"type": "string"
},
"recommendedNextAction": {
"type": "string"
},
"responseBody": {},
"retryAfterSeconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"retryable": {
"type": "boolean"
},
"status": {
"type": "integer"
}
},
"required": [
"code",
"message",
"retryable",
"retryAfterSeconds",
"recommendedNextAction"
],
"type": "object"
},
{
"type": "null"
}
]
},
"gpcResponse": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"activityComparison": {
"additionalProperties": false,
"properties": {
"activity": {
"additionalProperties": false,
"properties": {
"advertisingMarketing": {
"additionalProperties": false,
"properties": {
"baselineRequests": {
"maximum": 5000,
"minimum": 0,
"type": "integer"
},
"baselineServices": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
},
"gpcRequests": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
},
"gpcServices": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing/properties/baselineRequests"
}
},
"required": [
"baselineRequests",
"gpcRequests",
"baselineServices",
"gpcServices"
],
"type": "object"
},
"analyticsReplay": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/activityComparison/properties/activity/properties/advertisingMarketing"
}
},
"required": [
"advertisingMarketing",
"analyticsReplay"
],
"type": "object"
},
"causedByGpc": {
"const": "not_established",
"type": "string"
},
"contractVersion": {
"const": "certscore.gpc-activity-comparison.v1",
"type": "string"
},
"durationMs": {
"enum": [
250,
500,
1000
],
"type": "number"
},
"scanId": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"scope": {
"const": "matched_post_commit_request_window",
"type": "string"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"sourceHashes": {
"additionalProperties": false,
"properties": {
"baseline": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"gpc": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"baseline",
"gpc"
],
"type": "object"
},
"status": {
"const": "measured",
"type": "string"
}
},
"required": [
"contractVersion",
"scanId",
"status",
"scope",
"durationMs",
"sourceHashes",
"activity",
"scoreEffect",
"causedByGpc"
],
"type": "object"
},
"californiaPolicy": {
"additionalProperties": false,
"properties": {
"applied": {
"type": "boolean"
},
"deductionPoints": {
"enum": [
0,
15
],
"type": "number"
}
},
"required": [
"applied",
"deductionPoints"
],
"type": "object"
},
"comparison": {
"additionalProperties": false,
"properties": {
"baselineArtifact": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"lane": {
"const": "runtime_evidence",
"type": "string"
},
"sha256": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"sizeBytes": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"lane",
"sha256",
"sizeBytes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"comparable": {
"type": "boolean"
},
"coverage": {
"additionalProperties": false,
"properties": {
"comparedThroughMs": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"complete",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"status",
"comparedThroughMs"
],
"type": "object"
},
"delivery": {
"additionalProperties": false,
"properties": {
"status": {
"enum": [
"verified",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"deltas": {
"additionalProperties": false,
"properties": {
"advertisingOrMarketingActivity": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"advertisingOrMeasurementActivity": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"consentOrCmpBehavior": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"cookies": {
"additionalProperties": false,
"properties": {
"baselineCount": {
"minimum": 0,
"type": "integer"
},
"baselineOnly": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"baselineOnlyCount": {
"minimum": 0,
"type": "integer"
},
"countDelta": {
"type": "integer"
},
"gpcCount": {
"minimum": 0,
"type": "integer"
},
"gpcOnly": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"gpcOnlyCount": {
"minimum": 0,
"type": "integer"
},
"samplesTruncated": {
"type": "boolean"
},
"shared": {
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"sharedCount": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"baselineCount",
"gpcCount",
"countDelta",
"baselineOnly",
"gpcOnly",
"shared"
],
"type": "object"
},
"trackers": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
},
"webStorage": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/comparison/properties/deltas/properties/cookies"
}
},
"required": [
"cookies",
"trackers",
"advertisingOrMeasurementActivity",
"consentOrCmpBehavior"
],
"type": "object"
},
"enabledProof": {
"additionalProperties": false,
"properties": {
"navigatorGlobalPrivacyControl": {
"type": [
"boolean",
"null"
]
},
"requestEventIds": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"requestsWithSecGpc": {
"minimum": 0,
"type": "integer"
},
"secGpcHeaderValue": {
"anyOf": [
{
"const": "1",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"secGpcHeaderValue",
"requestsWithSecGpc",
"requestEventIds",
"navigatorGlobalPrivacyControl"
],
"type": "object"
},
"gpcArtifact": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"lane": {
"const": "gpc_observation",
"type": "string"
},
"sha256": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"sizeBytes": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"lane",
"sha256",
"sizeBytes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"limitationKeys": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"protocol": {
"const": "passive_baseline_with_sec_gpc",
"type": "string"
},
"responseBasis": {
"enum": [
"qualified_activity_reduction",
"no_qualified_reduction",
"insufficient_evidence"
],
"type": "string"
}
},
"required": [
"comparable",
"protocol",
"baselineArtifact",
"gpcArtifact",
"enabledProof",
"deltas",
"limitationKeys"
],
"type": "object"
},
"contractVersion": {
"enum": [
"certscore.gpc-response-assessment.v1",
"certscore.gpc-response-assessment.v2",
"certscore.gpc-response-assessment.v3"
],
"type": "string"
},
"evidenceUrl": {
"format": "uri",
"type": "string"
},
"findingTitle": {
"enum": [
"GPC response",
"No observable GPC response"
],
"type": "string"
},
"legalInterpretation": {
"const": "not_assessed",
"type": "string"
},
"observation": {
"additionalProperties": false,
"properties": {
"acknowledgment": {
"additionalProperties": false,
"properties": {
"captureComplete": {
"type": "boolean"
},
"observed": {
"type": "boolean"
}
},
"required": [
"observed",
"captureComplete"
],
"type": "object"
},
"contractVersion": {
"const": "certscore.gpc-bounded-observation.v1",
"type": "string"
},
"delivery": {
"additionalProperties": false,
"properties": {
"fullContextVerified": {
"type": "boolean"
},
"httpHeaderRetained": {
"type": "boolean"
},
"mainNavigatorReadbackRetained": {
"type": "boolean"
}
},
"required": [
"httpHeaderRetained",
"mainNavigatorReadbackRetained",
"fullContextVerified"
],
"type": "object"
},
"documentUrlSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"legalInterpretation": {
"const": "not_assessed",
"type": "string"
},
"limitationKeys": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 32,
"type": "array"
},
"registration": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "current_recorded_state",
"type": "string"
},
"causedByGpc": {
"const": "not_established",
"type": "string"
},
"cmpGpcSignal": {
"enum": [
"received",
"not_received",
"unknown"
],
"type": "string"
},
"sale": {
"enum": [
"opted_out",
"not_opted_out",
"unknown"
],
"type": "string"
},
"sharing": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/registration/properties/sale"
}
},
"required": [
"basis",
"sale",
"sharing",
"cmpGpcSignal",
"causedByGpc"
],
"type": "object"
},
"requests": {
"additionalProperties": false,
"properties": {
"blockedBeforeTransmissionCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"classifiedCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"collectionCount": {
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
"complete": {
"type": "boolean"
},
"count": {
"minimum": 0,
"type": "integer"
},
"documentCommittedAtMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
},
"evidenceIds": {
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"fromMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
},
"samplesTruncated": {
"type": "boolean"
},
"throughMs": {
"anyOf": [
{
"$ref": "#/properties/gpcResponse/anyOf/0/anyOf/1/anyOf/0/properties/observation/properties/requests/properties/count"
},
{
"type": "null"
}
]
}
},
"required": [
"count",
"blockedBeforeTransmissionCount",
"complete",
"fromMs",
"documentCommittedAtMs",
"throughMs",
"classifiedCount",
"collectionCount",
"evidenceIds",
"samplesTruncated"
],
"type": "object"
},
"scope": {
"const": "main_document_and_retained_http_requests",
"type": "string"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"semanticProbe": {
"enum": [
"observed",
"unsupported",
"unavailable",
"not_ready",
"invalid",
"incomplete"
],
"type": "string"
},
"sessionSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"sourceSha256": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"complete",
"limited",
"unavailable"
],
"type": "string"
}
},
"required": [
"contractVersion",
"scope",
"status",
"sourceSha256",
"sessionSha256",
"documentUrlSha256",
"delivery",
"semanticProbe",
"registration",
"acknowledgment",
"requests",
"limitationKeys",
"scoreEffect",
"legalInterpretation"
],
"type": "object"
},
"scoreEffect": {
"const": "none",
"type": "string"
},
"status": {
"enum": [
"responsive",
"no_observable_response",
"indeterminate"
],
"type": "string"
},
"summary": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"status",
"findingTitle",
"summary",
"scoreEffect",
"legalInterpretation",
"comparison",
"californiaPolicy",
"evidenceUrl"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"interpretationGuidance": {
"additionalProperties": false,
"properties": {
"doNotInferLegalComplianceStatus": {
"const": true,
"type": "boolean"
},
"doNotInferUnobservedTechnologies": {
"const": true,
"type": "boolean"
},
"observableSignalsOnly": {
"const": true,
"type": "boolean"
},
"scoreLabel": {
"const": "CertScore score",
"type": "string"
},
"statement": {
"type": "string"
}
},
"required": [
"scoreLabel",
"observableSignalsOnly",
"doNotInferUnobservedTechnologies",
"doNotInferLegalComplianceStatus",
"statement"
],
"type": "object"
},
"jobId": {
"type": "string"
},
"links": {
"additionalProperties": true,
"properties": {
"docs": {
"type": "string"
},
"findings": {
"type": "string"
},
"latestDomainScan": {
"type": "string"
},
"pulse": {
"type": "string"
},
"report": {
"type": "string"
},
"self": {
"type": "string"
},
"status": {
"type": "string"
}
},
"type": "object"
},
"noGo": {
"additionalProperties": false,
"properties": {
"evidenceExcerpt": {
"maxLength": 360,
"type": "string"
},
"explanation": {
"type": "string"
},
"limitationKind": {
"enum": [
"target_site_state",
"scanner_access_limitation",
"scanner_capture_limitation"
],
"type": "string"
},
"reasonCode": {
"enum": [
"blank_or_unusable_page",
"loading_or_stalled",
"not_found_404",
"parked_or_placeholder",
"site_not_ready",
"captcha_or_challenge",
"access_denied_or_forbidden_page",
"authentication_required",
"rate_limited_429",
"server_error_5xx",
"configuration_error",
"maintenance_or_unavailable",
"tls_or_certificate_error",
"unsupported_region",
"target_unreachable_or_unsuitable",
"navigation_transport_failure",
"visual_capture_failed_or_placeholder",
"retained_visual_error_shell",
"unknown"
],
"type": "string"
},
"recommendedNextAction": {
"type": "string"
},
"retryLikelyToHelp": {
"type": "boolean"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"reasonCode",
"title",
"explanation",
"summary",
"limitationKind",
"recommendedNextAction",
"retryLikelyToHelp"
],
"type": "object"
},
"observationOnlyDisclaimer": {
"type": "string"
},
"postAcceptObservation": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"acceptanceExercised": {
"type": "boolean"
},
"afterAction": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"accept",
"reject"
],
"type": "string"
},
"activationStatus": {
"enum": [
"completed",
"uncertain"
],
"type": "string"
},
"policyVersion": {
"enum": [
"bounded_after_action_capture.v1",
"bounded_after_action_capture.v2"
],
"type": "string"
},
"requestCount": {
"minimum": 0,
"type": "integer"
},
"requestsDropped": {
"minimum": 0,
"type": "integer"
},
"stopReason": {
"enum": [
"window_elapsed",
"aborted",
"target_changed",
"click_uncertain"
],
"type": "string"
},
"storageSnapshotRetained": {
"type": "boolean"
},
"storageWriteCount": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"policyVersion",
"action",
"activationStatus",
"stopReason",
"requestsDropped",
"requestCount",
"storageWriteCount",
"storageSnapshotRetained"
],
"type": "object"
},
"completedAt": {
"type": [
"string",
"null"
]
},
"coverageLimitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"evidenceDisposition": {
"enum": [
"confirmed",
"indeterminate"
],
"type": "string"
},
"execution": {
"additionalProperties": false,
"properties": {
"clickCompleted": {
"type": "boolean"
},
"consentConfirmed": {
"type": "boolean"
},
"observationCompleted": {
"type": "boolean"
},
"policyVersion": {
"const": "choice_path_execution.v1",
"type": "string"
},
"status": {
"enum": [
"succeeded",
"succeeded_with_confirmation",
"limited",
"not_attempted",
"unsupported"
],
"type": "string"
}
},
"required": [
"policyVersion",
"status",
"clickCompleted",
"observationCompleted",
"consentConfirmed"
],
"type": "object"
},
"indeterminateReason": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"interpretation": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"observationCount": {
"minimum": 0,
"type": "integer"
},
"observationStrategy": {
"enum": [
"stop_on_first_eligible_activity",
"not_applicable"
],
"type": "string"
},
"productionProjectable": {
"type": "boolean"
},
"status": {
"enum": [
"confirmed_observation",
"confirmed_clean",
"unconfirmed",
"not_attempted",
"unsupported",
"aborted"
],
"type": "string"
},
"termination": {
"additionalProperties": false,
"properties": {
"intentional": {
"type": "boolean"
},
"kind": {
"enum": [
"evidence_satisfied",
"window_elapsed",
"unavailable"
],
"type": "string"
},
"trigger": {
"enum": [
"non_essential_request_observed",
"non_essential_storage_write_observed",
"acceptance_signal_contradiction_observed",
"window_elapsed",
"accept_control_not_observed",
"accept_path_timeout",
"accept_observation_window_truncated",
"worker_failed",
"unavailable"
],
"type": "string"
}
},
"required": [
"kind",
"intentional",
"trigger"
],
"type": "object"
},
"verdict": {
"enum": [
"eligible_nonessential_activity_observed_after_confirmed_acceptance",
"retained_consent_signal_contradiction_observed_after_confirmed_acceptance",
"no_eligible_nonessential_activity_observed_during_completed_window",
"no_confirmed_post_accept_verdict"
],
"type": "string"
}
},
"required": [
"status",
"acceptanceExercised",
"observationCount",
"productionProjectable",
"evidenceDisposition",
"indeterminateReason",
"verdict",
"interpretation",
"observationStrategy",
"termination",
"completedAt",
"coverageLimitations",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"postRefusalObservation": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"afterAction": {
"$ref": "#/properties/postAcceptObservation/anyOf/0/anyOf/1/anyOf/0/properties/afterAction"
},
"completedAt": {
"type": [
"string",
"null"
]
},
"coverageLimitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"evidenceDisposition": {
"enum": [
"confirmed",
"indeterminate"
],
"type": "string"
},
"execution": {
"$ref": "#/properties/postAcceptObservation/anyOf/0/anyOf/1/anyOf/0/properties/execution"
},
"indeterminateReason": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"interpretation": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"observationCount": {
"minimum": 0,
"type": "integer"
},
"observationStrategy": {
"enum": [
"stop_on_first_eligible_activity",
"not_applicable"
],
"type": "string"
},
"productionProjectable": {
"type": "boolean"
},
"refusalExercised": {
"type": "boolean"
},
"status": {
"enum": [
"confirmed_observation",
"confirmed_clean",
"unconfirmed",
"not_attempted",
"unsupported",
"aborted"
],
"type": "string"
},
"termination": {
"additionalProperties": false,
"properties": {
"intentional": {
"type": "boolean"
},
"kind": {
"enum": [
"evidence_satisfied",
"window_elapsed",
"unavailable"
],
"type": "string"
},
"trigger": {
"enum": [
"non_essential_request_observed",
"non_essential_storage_write_observed",
"refusal_signal_contradiction_observed",
"window_elapsed",
"reject_path_timeout",
"worker_failed",
"unavailable"
],
"type": "string"
}
},
"required": [
"kind",
"intentional",
"trigger"
],
"type": "object"
},
"verdict": {
"enum": [
"eligible_nonessential_activity_observed_after_confirmed_refusal",
"retained_consent_signal_contradiction_observed_after_confirmed_refusal",
"no_eligible_nonessential_activity_observed_during_completed_window",
"no_confirmed_post_refusal_verdict"
],
"type": "string"
}
},
"required": [
"status",
"refusalExercised",
"observationCount",
"productionProjectable",
"evidenceDisposition",
"indeterminateReason",
"verdict",
"interpretation",
"observationStrategy",
"termination",
"completedAt",
"coverageLimitations",
"limitations"
],
"type": "object"
},
{
"type": "null"
}
]
}
]
},
{
"type": "null"
}
]
},
"preConsentPreview": {
"additionalProperties": false,
"properties": {
"cookies": {
"items": {
"additionalProperties": false,
"properties": {
"domain": {
"anyOf": [
{
"maxLength": 253,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"essentiality": {
"enum": [
"essential",
"non_essential",
"unknown"
],
"type": "string"
},
"name": {
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"observedAtMs": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"party": {
"enum": [
"first_party",
"third_party",
"unknown"
],
"type": "string"
},
"purpose": {
"enum": [
"analytics",
"advertising",
"marketing",
"personalization",
"session_replay",
"consent_management",
"tag_management",
"infrastructure",
"security",
"performance_monitoring",
"customer_support",
"unknown"
],
"type": "string"
}
},
"required": [
"name",
"domain",
"party",
"purpose",
"essentiality",
"observedAtMs"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"final": {
"const": false,
"type": "boolean"
},
"generatedAt": {
"format": "date-time",
"type": "string"
},
"mustContinuePolling": {
"const": true,
"type": "boolean"
},
"observationOnlyDisclaimer": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"operationalVendors": {
"items": {
"additionalProperties": false,
"properties": {
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"domains": {
"items": {
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"product": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"purpose": {
"enum": [
"analytics",
"advertising",
"marketing",
"personalization",
"session_replay",
"consent_management",
"tag_management",
"infrastructure",
"security",
"performance_monitoring",
"customer_support",
"unknown"
],
"type": "string"
},
"vendor": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"vendor",
"product",
"purpose",
"confidence",
"domains"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"resources": {
"items": {
"additionalProperties": false,
"properties": {
"confidence": {
"anyOf": [
{
"maximum": 1,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"domains": {
"items": {
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"kind": {
"enum": [
"request",
"embed"
],
"type": "string"
},
"observedAtMs": {
"minimum": 0,
"type": "integer"
},
"party": {
"enum": [
"first_party",
"third_party",
"mixed",
"unknown"
],
"type": "string"
},
"product": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"purpose": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"requestCount": {
"minimum": 0,
"type": "integer"
},
"vendor": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"vendor",
"product",
"purpose",
"confidence",
"domains",
"party",
"observedAtMs",
"requestCount"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"resultStage": {
"const": "preliminary",
"type": "string"
},
"runtimeCoverage": {
"additionalProperties": false,
"properties": {
"limitationKeys": {
"items": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxItems": 16,
"type": "array"
},
"status": {
"enum": [
"usable",
"limited_partial",
"limited_none",
"not_applicable"
],
"type": "string"
}
},
"required": [
"status",
"limitationKeys"
],
"type": "object"
},
"sourceLane": {
"const": "runtime_evidence",
"type": "string"
},
"summary": {
"additionalProperties": false,
"properties": {
"cookieCount": {
"minimum": 0,
"type": "integer"
},
"operationalVendorCount": {
"minimum": 0,
"type": "integer"
},
"returnedCookieCount": {
"minimum": 0,
"type": "integer"
},
"returnedOperationalVendorCount": {
"minimum": 0,
"type": "integer"
},
"returnedTrackingVendorCount": {
"minimum": 0,
"type": "integer"
},
"thirdPartyRequestCount": {
"minimum": 0,
"type": "integer"
},
"trackerCount": {
"minimum": 0,
"type": "integer"
},
"trackingVendorCount": {
"minimum": 0,
"type": "integer"
},
"vendorCount": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"cookieCount",
"trackerCount",
"thirdPartyRequestCount",
"vendorCount"
],
"type": "object"
},
"trackers": {
"items": {
"additionalProperties": false,
"properties": {
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"domains": {
"items": {
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"product": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"purpose": {
"enum": [
"analytics",
"advertising",
"marketing",
"personalization",
"session_replay",
"consent_management",
"tag_management",
"infrastructure",
"security",
"performance_monitoring",
"customer_support",
"unknown"
],
"type": "string"
},
"vendor": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"vendor",
"product",
"purpose",
"confidence",
"domains"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"truncated": {
"additionalProperties": false,
"properties": {
"cookies": {
"type": "boolean"
},
"operationalVendors": {
"type": "boolean"
},
"resources": {
"type": "boolean"
},
"trackers": {
"type": "boolean"
}
},
"required": [
"cookies",
"trackers"
],
"type": "object"
},
"type": {
"const": "certscore_pre_consent_preview",
"type": "string"
}
},
"required": [
"type",
"resultStage",
"final",
"sourceLane",
"generatedAt",
"runtimeCoverage",
"summary",
"cookies",
"trackers",
"truncated",
"mustContinuePolling",
"observationOnlyDisclaimer"
],
"type": "object"
},
"provenance": {
"additionalProperties": false,
"properties": {
"creationDecision": {
"enum": [
"new_scan",
"reused_scan",
"unknown"
],
"type": "string"
},
"executionMode": {
"anyOf": [
{
"enum": [
"new_scan",
"reused_scan"
],
"type": "string"
},
{
"type": "null"
}
]
},
"freshnessDecision": {
"type": [
"string",
"null"
]
},
"mode": {
"enum": [
"new_scan_started",
"existing_completed_scan_reused",
"existing_scan_retrieved",
"unknown"
],
"type": "string"
},
"retrievalMode": {
"enum": [
"creation_response",
"scan_id_lookup",
"unknown"
],
"type": "string"
},
"reused": {
"type": [
"boolean",
"null"
]
},
"scanAgeSeconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"mode",
"retrievalMode",
"creationDecision",
"scanAgeSeconds",
"executionMode",
"reused",
"freshnessDecision"
],
"type": "object"
},
"recommendedNextAction": {
"type": "string"
},
"recommendedNextTool": {
"anyOf": [
{
"enum": [
"certscore_get_scan_status",
"certscore_get_scan_bundle"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportUrl": {
"type": [
"string",
"null"
]
},
"resultDisposition": {
"enum": [
"no_go"
],
"type": "string"
},
"riskLevel": {
"type": [
"string",
"null"
]
},
"scanFrom": {
"enum": [
"eu_de",
"eu_ie",
"california"
],
"type": "string"
},
"scanId": {
"type": [
"string",
"null"
]
},
"scanTimeSeconds": {
"type": [
"number",
"null"
]
},
"score": {
"anyOf": [
{
"maximum": 100,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"scoreLabel": {
"const": "CertScore score",
"type": "string"
},
"scoreStatus": {
"enum": [
"provisional",
"final"
],
"type": "string"
},
"scoreUpdatedAt": {
"type": [
"string",
"null"
]
},
"scoreVersion": {
"type": [
"string",
"null"
]
},
"startedAt": {
"type": [
"string",
"null"
]
},
"status": {
"anyOf": [
{
"enum": [
"queued",
"running",
"finalizing",
"completed",
"completed_limited",
"failed",
"expired",
"rate_limited"
],
"type": "string"
},
{
"const": "invalid_arguments",
"type": "string"
}
]
},
"type": {
"enum": [
"certscore_scan",
"certscore_scan_job",
"certscore_tool_error"
],
"type": "string"
}
},
"required": [
"type",
"status",
"scoreLabel",
"error",
"provenance",
"interpretationGuidance",
"recommendedNextTool",
"recommendedNextAction",
"observationOnlyDisclaimer"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:b8f80b279996e60577ff83c0be38bbe887c89868ccf189d4935e1771b4f57178 | sha256sum