---
title: "Unseen Imports"
method: GET
path: "/saved/unseen"
tags: ["saved"]
---

# Unseen Imports

`GET /saved/unseen`

The posts that arrived from the iOS share extension while the user was
away — the Saved tab's unread badge.

Two gates, both required: `unseen` (never surfaced) and a social
`source` (a post, not a list the user built). `failed` imports are excluded
— there is nothing to go and look at, so badging one would send the user to
a dead end.

## Response `200`

Successful Response

- UnseenImportsOut — Posts that landed from the share extension while the user was away. `count` is the badge number; `lists` are the same `SavedListOut` rows the Saved page already renders, so a richer "here's what arrived" surface can be built entirely client-side off this one call.
  - `count` integer, required
  - `lists` SavedListOut[], required
    - `id` string, uuid, required
    - `title` string, required
    - `source` string, required
    - `source_url` string, nullable, required
    - `source_author` string, nullable, required
    - `city` string, nullable, required
    - `cover_image_url` string, nullable, required
    - `item_count` integer, required
    - `is_shared` boolean, required
    - `status` string, required
    - `failed_reason` 'post_unavailable', nullable
    - `created_at` string, required
    - `updated_at` string, required
    - `visibility` 'public' | 'private', required
    - `slug` string, nullable, required
    - `public_url` string, nullable, required
    - `routes` SavedRouteOut[]
      - `id` string, uuid, required
      - `list_id` string, uuid, required
      - `name` string, required
      - `activity` string, required
      - `status` string, required
      - `chains` string[], required
      - `length_m` integer, required
      - `ascent_m` integer, required
      - `descent_m` integer, required
      - `min_elev_m` number, required
      - `max_elev_m` number, required
      - `profile` object, nullable
      - `tag_lengths` object, nullable
      - `osm_name` string, nullable
      - `claimed_length_km` number, nullable
      - `claimed_ascent_m` number, nullable
      - `place_item_id` string, uuid, nullable

---

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