Public dashboard viewer (unauthenticated)

GET/api/v1/public/dashboards/{token}

Resolve a share token to a read-only, redacted dashboard. Returns 404 for unknown, expired, revoked, or deleted targets — the four are indistinguishable on purpose. Rate-limited per IP and cached for 60 seconds; the payload reflects each widget's stored snapshot, so it is exactly as fresh as the dashboard itself.

Operation ID: fetch_public_dashboard_api_v1_public_dashboards__token__get·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

tokenstringrequired

Responses

200Successful Response

Schema: SuccessEnvelope_PublicDashboardResponse_

successboolean
messagestring
codestring
dataPublicDashboardResponse

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError

5 fields

locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject

429Too Many Requests - Rate limit exceeded

Code samples

GET/api/v1/public/dashboards/{token}

bash

curl -X GET 'https://api.ondayzero.com/api/v1/public/dashboards/{token}' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID'