---
title: "Get Guide"
method: GET
path: "/guides/user/{username}/{slug}"
tags: ["guides"]
---

# Get Guide

`GET /guides/user/{username}/{slug}`

Get guide data by username and slug. Returns full data for public, meta-only for private.

Pass ?lean=1 to skip heavy data (card_data, plan, itinerary) for SSR.

## Path parameters

- `username` string, required
- `slug` string, required

## Query parameters

- `lean` boolean

## Response `200`

Successful Response

- GuideResponse — Response for the public guide endpoint. Full data for public, meta-only for private.
  - `visibility` string, required
  - `meta` GuideMetaResponse, required — Minimal metadata for the SSR shell (works for both public and private).
    - `title` string, nullable
    - `hero_photo_url` string, nullable
    - `hero_portrait_photo_url` string, nullable
    - `creator_name` string, nullable
    - `visibility` string, required
    - `kudos_count` integer
  - `data` SharedTripResponse — Single-payload response for the shared trip page. Mirrors the 5 data buckets the authenticated frontend uses: trip metadata, display overview, plan, raw itinerary, and card data.
    - `title` string, nullable
    - `hero_photo_url` string, nullable
    - `hero_portrait_photo_url` string, nullable
    - `has_plan` boolean
    - `extracted_destination` ExtractedDestination — Extracted destination for map zoom.
      - `name` string, required
      - `type` string, nullable
      - `country_code` string, nullable
      - `latitude` number, required
      - `longitude` number, required
    - `creator_name` string, nullable
    - `created_at` string, nullable
    - `overview` TripDisplayResponse, required — Response containing pre-formatted display data for Trip tab. Uses dictionary structure (Option B) for extensibility and clean separation of IDs from data. Journeys are discriminated by 'kind' field. car_rentals defaults to empty so older construction sites stay valid.
      - `journeys` object, required
      - `stays` object, required
      - `activities` object, required
      - `car_rentals` object
    - `plan` PlanContent — The full plan document stored in the DB.
      - `schema_version` integer
      - `migrated_at` string, date-time, nullable
      - `preamble` union[]
        - union
          - ActivityRefEntry — Standalone attraction card — a reference to an activity in the itinerary. In v2, a ref can carry a plain-text `note` annotation and an optional `time` — both user-authored on the attraction card.
            - `id` string, required
            - `type` 'activity_ref'
            - `item_id` string, required
            - `note` string, nullable
            - `time` string, time, nullable
          - ActivityGroupEntry — A group of activity refs rendered as a single carousel/cluster card.
            - `id` string, required
            - `type` 'activity_group'
            - `item_ids` string[]
            - `title` string, nullable
            - `caption` string, nullable
            - `time` string, time, nullable
          - FlightRefEntry — One SEGMENT of a flight leg placed in the day's entry flow. Granularity is the individual takeoff/landing: a connecting leg seeds one entry per hop, each on the day of THAT hop's departure date (so an after-midnight connection sits on the next day). ``segment_index`` defaults to 0, which keeps pre-segment entries valid — an old per-leg entry reconciles as the leg's first hop and the remaining segments seed fresh. The segment's data lives in the itinerary (``journey_id`` + ``leg_index`` + ``segment_index``); only the position within the day is user-owned. The server seeds and reconciles these entries inside ``validate_plan`` (see ``api.plan.service._reconcile_flight_entries``) so a flight is a first-class, user-orderable entry rather than a card derived at render time. ``time`` is a server-stamped copy of the segment's local departure ``"HH:MM"`` so time-based sorting treats a flight like any other timed entry. It is ``None`` for a date-only import (departure == arrival, zero duration) so the day sorts it to the top rather than at a bogus 00:00. Because the position is user-owned once seeded, ``set_entry_time`` and ``remove_entry`` are rejected for this type (time comes from the itinerary; a removed flight would silently reappear on the next validate) while ``move_entry`` is allowed — repositioning is the whole point.
            - `id` string, required
            - `type` 'flight_ref'
            - `journey_id` string, required
            - `leg_index` integer, required
            - `segment_index` integer
            - `time` string, time, nullable
          - NoteEntry — Freeform text section. The `nodes` field stores the raw Lexical serialized node tree for lossless round-tripping of rich text. `content` always carries a plain-text fallback. Inline refs in both `content` and `nodes` are activity-only in v2.
            - `id` string, required
            - `type` 'note'
            - `content` string
            - `nodes` object, nullable
            - `time` string, time, nullable
          - TimeEntry — Time marker as a standalone entry.
            - `id` string, required
            - `type` 'time'
            - `time` string, time, required
          - EclipseSiteEntry — Eclipse viewing-site node — identity + coordinates only. On an eclipse-mode plan the eclipse day carries this single node. The web client renders it as a live eclipse-circumstances "mini-dossier" card: every contact time, totality duration, sun altitude, horizon margin, and cloud figure is computed CLIENT-SIDE from the coordinates (the existing `/eclipse/point` machinery). The backend supplies ONLY identity + coords — it never writes circumstance data into the plan. Two forms mirror how the site was chosen: - a known trip place: `ref_id` is the itinerary activity ULID it points at, and `latitude`/`longitude` are copied from that place's record at parse/serialize time (so the card is self-contained even if the place is later removed from the trip); - raw coordinates from "plan around this point": `ref_id` is None and the pair is the site. Discriminator note: `type` is the PlanEntry union tag — every consumer (backend union, payload sanitizer, revision diff, streaming deltas, the web and mobile entry switches) keys entries on `type`, so it MUST be present. `kind` duplicates it for the frontend card contract. They are always equal.
            - `id` string, required
            - `type` 'eclipse_site'
            - `kind` 'eclipse_site'
            - `label` string, required
            - `latitude` number, required
            - `longitude` number, required
            - `ref_id` string, nullable
      - `days` PlanDay[] — unresolved $ref
    - `itinerary` Itinerary — A simple container for user-curated trip elements. Stores journeys, stays, activities and car rentals as dictionaries keyed by an external id so add/remove can be O(1) and stable across updates. Activity = Attraction | Event — both live in the same dict. car_rentals defaults to empty so snapshots written before the key existed validate unchanged.
      - `journeys` object
      - `stays` object
      - `activities` object
      - `car_rentals` object
    - `shared_plan` SharedPlanContent — Pre-parsed plan for the shared page.
      - `preamble` SharedNoteBlock[]
        - `type` 'paragraph' | 'heading' | 'bullet_list' | 'numbered_list' | 'quote', required
        - `segments` InlineSegment[]
          - `type` 'text' | 'bold' | 'italic' | 'bold_italic' | 'activity_ref' | 'time', required
          - `text` string
          - `activity_id` string, nullable
          - `time` string, nullable
        - `level` integer, nullable
        - `items` SharedListItem[]
          - `segments` InlineSegment[]
            - `type` 'text' | 'bold' | 'italic' | 'bold_italic' | 'activity_ref' | 'time', required
            - `text` string
            - `activity_id` string, nullable
            - `time` string, nullable
          - `children` SharedListItem[]
      - `days` SharedPlanDay[] — unresolved $ref
      - `trip_suggestions` string[]
    - `card_data` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)