---
title: "Get Shared Project"
method: GET
path: "/api/v1/share/{share_token}"
tags: ["share"]
---

# Get Shared Project

`GET /api/v1/share/{share_token}`

Get metadata for a shared project (read-only, no side effects).

This is the primary entry point for shared project access. Validates
the share token and returns project metadata. View count tracking is
handled separately via POST /{share_token}/view.

Args:
    share: Validated ProjectShare from token (injected by validate_share_token)
    share_service: ProjectShareService for fetching project data

Returns:
    Shared project metadata (subset of full project data)

Raises:
    HTTPException: 404 if project not found

## Path parameters

- `share_token` string, required

## Response `200`

Successful Response

- SharedProjectResponse — API response model for a shared project (public, no auth). Exposes only the fields needed for read-only viewing. Intentionally omits internal fields like user_id, project_plan, visibility, is_plan_ready, and additional_project_info.
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `default_view_id` string, nullable
  - `thumbnail_bounds` ThumbnailBounds — Bounding box for project thumbnail map rendering. Represents the geographic extent of project features for generating static map thumbnails via Mapbox.
    - `min_lon` number, required
    - `min_lat` number, required
    - `max_lon` number, required
    - `max_lat` number, required
  - `is_sandbox` boolean
  - `created_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.net/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/versions/ba2b8d962161/schema)