Just create a list right now: a table of what we need and what it does, and then a list of APIs we will need for all the screens.
The same prompt as the components table. Each API is mapped to the screens that call it.
Plush Scout · build spec · draft 3 Oct 2026
What we need to build one Expo app that serves iOS, Android and the web from the same code. It covers every component (and whether it needs a separate web file), which components each screen uses, and the API each screen calls. Drawn from the iOS design explorer, the Liquid Glass sets and the web app designs.
REST on Cloudflare Workers (Hono), signed in with Supabase auth. Prices come back in pence or cents with a currency. The API ids in the screens table match the first column here.
| Id | Method | Path | What it does | Screens | Notes |
|---|---|---|---|---|---|
| Account | |||||
| me | GET | /me | Profile, market and plan: free, trial or pro; weekly, monthly, yearly or lifetime; trial end and renewal dates; the plan's limits and what has been used (alerts on, checks this month). | S1, S9, S14, S15, S16 | Auth required. Every screen uses the plan to show or lock Pro sections. Limits come from the server, so they can change without an app update. |
| me-update | PATCH | /me | Change market, currency, notification and theme preferences. | S14, S16 | |
| push-token | POST | /me/push-tokens | Register an Expo push token (and later a web push subscription). | S10, S14, S16 | DELETE /me/push-tokens/:token to remove. |
| Catalogue | |||||
| catalogue-search | GET | /plushes | Browse and search designs: q, line, animal, status, size, page. | S6 | Public, cached at the edge. |
| search-suggest | GET | /search/suggest | Typeahead across plush, tag codes and shops. | S6, S11 | Public, short cache. |
| plush | GET | /plushes/:slug | Design with every size: status, height, tag code, RRP per market, photos. | S7, S10 | Public. |
| Prices | |||||
| variant-market | GET | /variants/:id/market | Verdict numbers: lowest, typical range, highest, good/fair/high, sold in 90 days, stockists in stock. | S7 | Query: market. |
| price-history | GET | /variants/:id/price-history | Daily median asking price plus sold points for the chart. | S7 | Query: market, range (1m, 3m, 1y, all). Free gets the last 30 days; longer ranges need Pro. |
| listings | GET | /variants/:id/listings | Every listing with filters, sort and paging; includes facet counts. | S7, S8 | Query: market, condition, source, in_stock, sort, cursor. |
| histogram | GET | /variants/:id/listings/histogram | Price buckets for the spread chart and the alert match preview. | S7, S8, S10 | Same filters as listings. |
| sales | GET | /variants/:id/sales | Recent sold prices. | S7 | Query: market, limit, filters. Free gets the latest 3 plus the total count; Pro gets all. |
| where-to-buy | GET | /variants/:id/where-to-buy | Nearest shop in stock, cheapest online shop and resale floor. | S4, S7 | Query: lat, lng, market. |
| out | GET | /out/:listingId | Redirect to the listing with affiliate tracking; logs the click. | S7, S8 | Adds the eBay Partner Network custom id per surface. |
| Feeds | |||||
| feed-retired | GET | /feed/retired | Recently retired designs with resale change. | S1, S6 | Public. |
| wants-drops | GET | /me/wants/price-drops | Price drops on your wanted list. | S1 | |
| feed-matches | GET | /me/alerts/matches | Alerts that fired, newest first. | S1, S9 | Cursor paging. |
| radar | GET | /me/radar | Tonight's drop window and how many of your wants are being watched. | S1 | Never returns check timings. |
| Shelf | |||||
| collection-list | GET | /me/collection | Your plush with value, filters and paging. | S2 | Query: collection, status, size, sort, cursor. |
| collection-summary | GET | /me/collection/summary | Owned, value, retired, paid and a 12-month value series. | S1, S2 | Value and the series are Pro; Free gets the counts. |
| collection-add | POST | /me/collection | Add a plush: size, condition, tags on, price paid, date, shop, photos. | S2, S7 | |
| collection-edit | PATCH | /me/collection/:itemId | Edit or (DELETE) remove an item. | S2 | |
| collections | GET | /me/collections | Named shelves; POST, PATCH and DELETE to manage them. | S2 | |
| wants-list | GET | /me/wants | Wanted list with current prices and changes. | S3 | |
| wants-add | POST | /me/wants | Add to wanted, with priority and an optional max price. | S3, S7 | |
| wants-remove | DELETE | /me/wants/:variantId | Remove from wanted. | S3 | |
| sets-detail | GET | /me/sets/:lineSlug | Every design and size in a line, marked owned or missing. | S4 | GET /me/sets lists all lines with progress. |
| milestones | GET | /me/milestones | Earned milestones and progress toward the next ones. | S5 | |
| export | POST | /me/collection/export | Builds a CSV of your shelf and returns a download link. | S2, S14 | |
| iso-card | POST | /me/share-card | Makes a shareable image of your wanted list or shelf and returns its link. | S2, S3 | |
| public-wants | GET | /u/:handle/wants | Public wanted list for the share link. | S17 | Public, only when the user turns sharing on. |
| uploads-sign | POST | /uploads/sign | Signed upload URL for a photo going to R2. | S2, S13 | Returns the image id to attach. |
| Alerts | |||||
| alerts-list | GET | /me/alerts | Your alerts with status, last match and quota. | S9 | |
| alerts-create | POST | /me/alerts | Create an alert: type, plush or size or shop, max price, markets, conditions, sources, channels. | S3, S7, S8, S10 | Free: 3 alerts on at a time. A 4th returns 402 plan_limit (reason alerts) and the app opens the paywall. |
| alerts-edit | PATCH | /me/alerts/:id | Turn on or off, or edit the rule. | S9, S10 | |
| alerts-delete | DELETE | /me/alerts/:id | Delete an alert. | S9 | |
| Shops | |||||
| stores-near | GET | /stores | Shops near a point with stock and price for a plush size. | S11 | Query: lat, lng, radius, variant, in_stock, official, open_now. |
| store | GET | /stores/:id | One shop: address, website, opening hours (fetched live from Google per its terms), online range. | S12 | |
| store-stock | GET | /stores/:id/stock | Which of your wants this shop has now. | S12 | |
| Check a plush | |||||
| identify | GET | /identify | Find a plush from a tag code, SKU or barcode. | S13 | Query: code. |
| auth-guide | GET | /auth-guides/:era | Checklist steps and reference photos for a tag era. | S13 | Public, cached. |
| checks-create | POST | /checks | Start a check with photos and a guessed plush. | S13 | Free: 3 a calendar month, photo ID included. A 4th returns 402 plan_limit (reason checks). |
| checks-answer | PATCH | /checks/:id | Save answers to checklist steps. | S13 | |
| checks-result | POST | /checks/:id/result | Work out the confidence result. | S13 | |
| evidence-pdf | POST | /checks/:id/evidence-pdf | Make the dispute evidence PDF and return its link. | S13 | Pro only; Free gets 402 plan_limit (reason evidence_pdf). PDFs made while on Pro stay downloadable. |
| Billing | |||||
| plans | GET | /billing/plans | Pro prices in the user's market for weekly, monthly, yearly and lifetime, and whether the 7-day trial is still available; also the Free and Pro comparison rows. | S15 | Trial is once per account. |
| checkout | POST | /billing/checkout | Web: start Stripe Checkout for weekly, monthly or yearly (with the trial) or lifetime. Apps buy through RevenueCat. | S15 | Webhooks /webhooks/stripe and /webhooks/revenuecat keep the plan in sync across devices. |
| billing-portal | POST | /billing/portal | Web: open Stripe's billing page to cancel or change plan. Apps send people to the App Store or Google Play. | S15 | |