---
title: "A public account home"
method: GET
path: "/api/public/by-handle/{handle}"
tags: ["public"]
---

# A public account home

`GET /api/public/by-handle/{handle}`

## Request

- Base URL: `https://telawiki.com`
- URL: `https://telawiki.com/api/public/by-handle/{handle}`
- Auth: none required

Resolves one namespace of users and organizations (a user wins a collision) and returns that account's published spaces and latest posts. An account with nothing published is a 404, same as an unknown handle.

## Response `200`

The account home.

- HandleHome
  - `kind` 'user' | 'org', required
  - `handle` string, required
  - `name` string, required
  - `bio` string, required: Empty for organizations.
  - `spaces` object[], required: Published spaces, most recently active first.
    - `id` integer, required
    - `name` string, required
    - `slug` string, required
    - `description` string, required
    - `page_count` integer, required
    - `updated_at` string, required
  - `posts` object[], required: Up to 6 recent top-level public pages across those spaces.
    - `space_id` integer, required
    - `space_name` string, required
    - `space_slug` string, required
    - `id` integer, required
    - `title` string, required
    - `created_at` string, required: `YYYY-MM-DD HH:MM:SS` in UTC.
    - `updated_at` string, required: `YYYY-MM-DD HH:MM:SS` in UTC.
    - `kind` 'deck' | 'sheet': Absent for an ordinary prose page.
    - `excerpt` string
    - `reading_minutes` integer
    - `cover` string
    - `tags` string[]

## Other responses

- `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)