Get a site by id or slug.

Stable site identifier.

Public subdomain slug, if the site is public.

Privacy mode.

Canonical URL to view the site.

Unix epoch seconds.

Unix epoch seconds.

Unix epoch seconds; null = no expiry. Clamped to the plan ceiling at write time (Free: 7 days, anonymous: 24 hours), so this can come back sooner than you asked for.

The same instant as expires_at, RFC 3339 UTC, second granularity (e.g. "2026-09-08T12:00:00Z"). Present so a client can show a deadline without reconstructing it from the epoch.

Seconds from now until the page stops serving. Null when it does not expire; 0 when it is already out of time. Never negative.

True when the lifetime THIS request asked for was longer than the plan allows and expires_at is the shortened reality. Always present, false included. False on reads, which ask for no lifetime. Asking for a page that never expires on a capped plan is refused (409 expiry_clamped) rather than clamped, unless accept_clamp is sent.

The longest lifetime this plan allows a page, in hours: 24 anonymous, 168 on Free, null on plans with no ceiling and on the paid one-off rails.

What decided the date: request (the caller named it), plan_ceiling (the plan cap did), plan_default (the plan default did), or stored (this call only read the row).

Total content size in bytes.

True when the plan has no viewer numbers (anonymous and Free). The three viewer fields below are then null; there is no number to reveal, blur, or approximate.

Whether anyone has opened the page. Returned on every plan, including when metrics_locked is true, so "someone read this" survives the lock.

Whether THIS page carries the "Made with Stacktree" footer as served on its stacktr.ee URL. Returned by GET /sites/{idOrSlug} only. A fact about the page, not about the plan: pages published before 2026-08-03, generated client portals and end-to-end encrypted pages carry no badge even on Free, and a remove_badge entitlement lifts it off one page or a whole account. Never assume it from the plan; anything offering to remove the badge should read this.

Raw view count. Null when metrics_locked.

Distinct human viewers over the last 30 days. Null when metrics_locked.

Unix epoch seconds of the most recent open. Null when metrics_locked, or when never opened.

Present on publish when the space has a connected hostname and the page got a space_path: the page’s address on the client’s own domain (e.g. https://acme.theiragency.com/june-report). Prefer handing this link to the user.

Anonymous publishes only. Adopts the page into an account (POST /sites/{idOrSlug}/claim) and, until then, is its keyless update credential. As sensitive as the page.

Anonymous publishes only. The dashboard claim screen for this page: sign in, and the page moves into that account at the same address.

Anonymous publishes only. Give this to the person you published for: it opens a page that says when this page stops working and offers both ways to keep it (a free account, or the link by email); opening it keeps nothing until they choose one. It also marks their browser so the page itself shows them a Keep button. It carries the claim token, so it is as sensitive as claim_url: share url, never this.

Unix epoch seconds the page stopped serving; null when it is live. Non-null means the URL is dead for everyone holding it.

Why it stopped serving: expired, owner (someone deleted it), abuse (a takedown), or merged (folded into another page; see merged_into). null while the page is live. abuse and merged are never restorable: POST /sites/{idOrSlug}/restore refuses them, so do not offer a restore control for either.

Unix epoch seconds. A real deadline, not a hint: the hourly cleanup destroys the content at that moment and restore returns 404 from then on.