---
title: "Read a shared page by token"
method: GET
path: "/api/share/{token}"
tags: ["shares"]
---

# Read a shared page by token

`GET /api/share/{token}`

## Request

- Base URL: `https://telawiki.com`
- URL: `https://telawiki.com/api/share/{token}`
- Auth: none required

No account needed — the token is the credential. Missing, revoked, and expired shares all answer with an identical 404.

## Response `200`

The share and its root page.

- object
  - `share` PublicShare, required: What a share tells an anonymous reader about itself.
    - `token` string, required
    - `include_descendants` boolean, required
    - `has_password` boolean, required
    - `expires_at` string, nullable
    - `source_url` string, required
  - `page` SharePage, required
    - `id` integer, required
    - `title` string, required
    - `body` string, required: Canonical markdown.
    - `updated_at` string, required: `YYYY-MM-DD HH:MM:SS` in UTC.

## Other responses

- `401`: `password_required` — this share is password-gated; call `POST /api/share/{token}/auth` first.
- `404`: `not_found`.
- `500`: `internal` — server error.

---

[API](https://skmtc.dev/telawiki/apis/tela-rest-api.md) · [All operations](https://skmtc.dev/telawiki/apis/tela-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/telawiki/apis/tela-rest-api/revisions/f316f31f6fcb?raw)