Documentation lookup
Retrieve the current Truth Score detail for one documented browser API. The response combines the overall page score with supporting signals, known discrepancies, and the evidence claims behind each signal.
/api/inventory/pages/[slug]application/json response01 / request
Path parameter
Look up one page by its required slug. URL-encode the value when it contains characters that are not safe in a path segment. This endpoint accepts no request body and has no query parameters.
| Field | Type | Required | Details |
|---|---|---|---|
| slug | string | Yes | Required path segment; URL-encode as needed. No body or query parameters. |
02 / success · 200
Response shape
A found page returns application/json matching InventoryPageDetail. Scores are numbers in the documented ranges; timestamps are Unix milliseconds generated from the current inventory record.
| Field | Type | Description |
|---|---|---|
| page | InventoryScoreCard | Overall page identity, score, status, evidence status, verification timestamp, and discrepancy count. |
| signals | InventorySignalRow[] | The spec, browser, examples, and compatibility signal rows. |
| discrepancies | InventoryDiscrepancy[] | Known issues linked to an evidence claim when one is available. |
| evidence | InventoryEvidence | Aggregate evidence status and the detailed claim records behind each signal. |
| slug · name | string · The requested slug and its display name. |
| score | Integer from 0 to 100. |
| status | Verified · Drift detected · Needs review · In review · Unverified |
| evidenceStatus | Verified · Partially verified · Not tested · Conflict detected |
| lastVerifiedAt · discrepancyCount | Unix-millisecond integer timestamp · non-negative integer. |
| id · label | spec · browser · examples · compat · plus a display label. |
| score · weight | Score is 0–100; weight is 0–1. |
| evidenceUrl | Optional string; omitted when the signal has no source URL. |
| explainer | Human-readable explanation of how the signal was scored. |
| id · summary | String identifier and human-readable description. |
| sourceUrl | string or null. |
| severity | drift · additive · editorial. |
| claimId | spec · browser · examples · compat · or null. |
| status | One of Verified, Partially verified, Not tested, or Conflict detected. |
| claims | Array of InventoryEvidenceClaim records; each claim has the fields listed below. |
| claim id · label · status · score | Claim id is spec, browser, examples, or compat; label is a string; status uses the evidence status enum; score is 0–100. |
| claim sources and details | specificationSource, specificationSection, specificationRevision, browserVerificationStatus, browser, browserVersion, exampleResult, compatibilityDetail, and gap are string | null. URL fields specificationLink, browserSource, exampleSource, and compatibilitySource are URL string | null. exampleLastVerifiedAt is integer | null. |
03 / example
Request and response
websocket-api is a seeded example slug. The response below is an illustrative shape: score, discrepancy totals, and verification timestamps are generated from the live inventory record and can change between requests.
curl "${APP_URL}/api/inventory/pages/websocket-api"{
"page": {
"slug": "websocket-api",
"name": "WebSocket API",
"score": 87,
"status": "Verified",
"evidenceStatus": "Partially verified",
"lastVerifiedAt": 1770000000000,
"discrepancyCount": 1
},
"signals": [
{
"id": "spec",
"label": "Specification",
"score": 92,
"weight": 0.3,
"evidenceUrl": "https://example.com/source",
"explainer": "Illustrative signal explanation."
}
],
"discrepancies": [],
"evidence": {
"status": "Partially verified",
"claims": [
{
"id": "spec",
"label": "Specification",
"status": "Verified",
"score": 92,
"specificationSource": "Illustrative source",
"specificationSection": null,
"specificationRevision": null,
"specificationLink": "https://example.com/spec",
"browserVerificationStatus": null,
"browser": null,
"browserVersion": null,
"browserSource": null,
"exampleResult": null,
"exampleSource": null,
"exampleLastVerifiedAt": null,
"compatibilitySource": null,
"compatibilityDetail": null,
"gap": null
}
]
}
}04 / errors
Not found
Unknown slugs return 404 with the exact JSON error body below. No login or other authorization is required for either the successful lookup or this not-found response.
{
"error": "not_found"
}