jirazolabsPlush Scout · Design artifactHow we designed it →
The 1 prompt behind this pageAll prompts →
  1. Prompt 01APIs

    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

API endpoints

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.

72components
20split into .tsx + .web.tsx
49shared, one file
17screens
47API endpoints

APIs

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.

IdMethodPathWhat it doesScreensNotes
Account
meGET/meProfile, 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, S16Auth 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-updatePATCH/meChange market, currency, notification and theme preferences.S14, S16
push-tokenPOST/me/push-tokensRegister an Expo push token (and later a web push subscription).S10, S14, S16DELETE /me/push-tokens/:token to remove.
Catalogue
catalogue-searchGET/plushesBrowse and search designs: q, line, animal, status, size, page.S6Public, cached at the edge.
search-suggestGET/search/suggestTypeahead across plush, tag codes and shops.S6, S11Public, short cache.
plushGET/plushes/:slugDesign with every size: status, height, tag code, RRP per market, photos.S7, S10Public.
Prices
variant-marketGET/variants/:id/marketVerdict numbers: lowest, typical range, highest, good/fair/high, sold in 90 days, stockists in stock.S7Query: market.
price-historyGET/variants/:id/price-historyDaily median asking price plus sold points for the chart.S7Query: market, range (1m, 3m, 1y, all). Free gets the last 30 days; longer ranges need Pro.
listingsGET/variants/:id/listingsEvery listing with filters, sort and paging; includes facet counts.S7, S8Query: market, condition, source, in_stock, sort, cursor.
histogramGET/variants/:id/listings/histogramPrice buckets for the spread chart and the alert match preview.S7, S8, S10Same filters as listings.
salesGET/variants/:id/salesRecent sold prices.S7Query: market, limit, filters. Free gets the latest 3 plus the total count; Pro gets all.
where-to-buyGET/variants/:id/where-to-buyNearest shop in stock, cheapest online shop and resale floor.S4, S7Query: lat, lng, market.
outGET/out/:listingIdRedirect to the listing with affiliate tracking; logs the click.S7, S8Adds the eBay Partner Network custom id per surface.
Feeds
feed-retiredGET/feed/retiredRecently retired designs with resale change.S1, S6Public.
wants-dropsGET/me/wants/price-dropsPrice drops on your wanted list.S1
feed-matchesGET/me/alerts/matchesAlerts that fired, newest first.S1, S9Cursor paging.
radarGET/me/radarTonight's drop window and how many of your wants are being watched.S1Never returns check timings.
Shelf
collection-listGET/me/collectionYour plush with value, filters and paging.S2Query: collection, status, size, sort, cursor.
collection-summaryGET/me/collection/summaryOwned, value, retired, paid and a 12-month value series.S1, S2Value and the series are Pro; Free gets the counts.
collection-addPOST/me/collectionAdd a plush: size, condition, tags on, price paid, date, shop, photos.S2, S7
collection-editPATCH/me/collection/:itemIdEdit or (DELETE) remove an item.S2
collectionsGET/me/collectionsNamed shelves; POST, PATCH and DELETE to manage them.S2
wants-listGET/me/wantsWanted list with current prices and changes.S3
wants-addPOST/me/wantsAdd to wanted, with priority and an optional max price.S3, S7
wants-removeDELETE/me/wants/:variantIdRemove from wanted.S3
sets-detailGET/me/sets/:lineSlugEvery design and size in a line, marked owned or missing.S4GET /me/sets lists all lines with progress.
milestonesGET/me/milestonesEarned milestones and progress toward the next ones.S5
exportPOST/me/collection/exportBuilds a CSV of your shelf and returns a download link.S2, S14
iso-cardPOST/me/share-cardMakes a shareable image of your wanted list or shelf and returns its link.S2, S3
public-wantsGET/u/:handle/wantsPublic wanted list for the share link.S17Public, only when the user turns sharing on.
uploads-signPOST/uploads/signSigned upload URL for a photo going to R2.S2, S13Returns the image id to attach.
Alerts
alerts-listGET/me/alertsYour alerts with status, last match and quota.S9
alerts-createPOST/me/alertsCreate an alert: type, plush or size or shop, max price, markets, conditions, sources, channels.S3, S7, S8, S10Free: 3 alerts on at a time. A 4th returns 402 plan_limit (reason alerts) and the app opens the paywall.
alerts-editPATCH/me/alerts/:idTurn on or off, or edit the rule.S9, S10
alerts-deleteDELETE/me/alerts/:idDelete an alert.S9
Shops
stores-nearGET/storesShops near a point with stock and price for a plush size.S11Query: lat, lng, radius, variant, in_stock, official, open_now.
storeGET/stores/:idOne shop: address, website, opening hours (fetched live from Google per its terms), online range.S12
store-stockGET/stores/:id/stockWhich of your wants this shop has now.S12
Check a plush
identifyGET/identifyFind a plush from a tag code, SKU or barcode.S13Query: code.
auth-guideGET/auth-guides/:eraChecklist steps and reference photos for a tag era.S13Public, cached.
checks-createPOST/checksStart a check with photos and a guessed plush.S13Free: 3 a calendar month, photo ID included. A 4th returns 402 plan_limit (reason checks).
checks-answerPATCH/checks/:idSave answers to checklist steps.S13
checks-resultPOST/checks/:id/resultWork out the confidence result.S13
evidence-pdfPOST/checks/:id/evidence-pdfMake the dispute evidence PDF and return its link.S13Pro only; Free gets 402 plan_limit (reason evidence_pdf). PDFs made while on Pro stay downloadable.
Billing
plansGET/billing/plansPro 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.S15Trial is once per account.
checkoutPOST/billing/checkoutWeb: start Stripe Checkout for weekly, monthly or yearly (with the trial) or lifetime. Apps buy through RevenueCat.S15Webhooks /webhooks/stripe and /webhooks/revenuecat keep the plan in sync across devices.
billing-portalPOST/billing/portalWeb: open Stripe's billing page to cancel or change plan. Apps send people to the App Store or Google Play.S15