Health Check
Is the API running? Hit one of these.
SignalR (Video Hub)
Connect to the real-time Video hub. You’ll see events when videos are uploaded, location groups updated, or videos deleted. Login required.
Hub URL: /hubs/videos. Connect with your current token, then upload or delete a video in the Videos section to see events here.
—
🔧 Azure SignalR REST — Test POST /api/v1/hubs/:hubName//:send
Paste the Azure SignalR connection string. The JWT is built in-browser (same logic as the Worker). This tests whether the Azure SignalR endpoint accepts the publish call.
—
Infra trace (SignalR · Redis · Service Bus)
Hub events in a sortable log. Development API only: inspect live-stream Redis keys and recent Service Bus publishes from this app (see Redis / Service Bus tabs).
Uses the same hub connection as Realtime. Connect once (either tab), then delete or upload a video to see VideoDeleted vs other events.
| Time | Kind | Event / line | Summary | Payload |
|---|
Health: GET /api/infra/runtime-health. Live stream Redis snapshot (Development): GET /api/infra/live-stream-redis/{sessionId} — session hash, viewers, activity, stream:meta, counters.
—
Recent messages published by this API (Development): GET /api/infra/live-stream-servicebus-recent?sessionId=…. Worker consumption → Azure Portal or Workers console.
—
Live monitor (Development API): GET /api/infra/live-monitor — active streams, Redis viewers (global), join/leave on this API node. Connect SignalR for real-time LiveStreamViewerCountUpdated. Multi-instance: open Test-UI against each pod URL.
Active live streams
| Session | Channel | DB viewers | Redis viewers | Redis user ids |
|---|
Join / leave on this API node
| Time | Action | User | Stream | Source | Count |
|---|
Last health summary
Live Stream Testing
Host and audience tokens, go-live, RTC preview, event-linked streams, request live, and report testing.
Normal user — What happens with Live & Report? (tap to collapse)
Without Report: Host Go Live → followers notify. Request live → receiver gets SignalR RequestLive (+ bell). Receiver Start = accept → requesters get “is now live”.
Report (live): 1 report → stream auto-stops for moderation, then admin can Approve or Reject.
Admin is not in normal go-live — only after reports (see Admin tab).
Login required. Flow: Event (optional) → Host token → Start → Join/End. Two accounts for request live: target must Connect hub (Realtime tab) for RequestLive.
Active live streams
All currently live sessions from GET /api/videos/my-videos/grouped-by-location. Connect Realtime → SignalR for instant viewer join/leave updates.
Live activity log (join / leave / SignalR)
Follow & go-live requests
source on go-live request.
(Pending requests JSON appears here.)
Event + live stream
The API attaches your stream to an event when coordinates match: ~30 m of a venue in Redis events:geo, or inside the geofence polygon when available.
Leave Event ID empty to let the backend pick the nearest match. Fill Event ID to force that event — you must still be within its area or you get a validation error.
eventId when a link was created. That value is summarized here for quick testing.
1) Token
2) Start stream
2.5) RTC publish/playback (Laptop cam)
3) Live Studio
Sequential flow after Start + RTC: Join stream → Open chat room → Chat & moderate.
Backend creates chatRoomId on start — no PATCH. Use another browser/user to join as viewer.
Live chat
Open chat room to start messaging
Comments must be ON for viewers to send.
3c) Report live stream (viewer)
Join as viewer (another account), paste Live stream ID above (ls_…). Reports via unified POST /api/videos/{id}/report (same reasons as videos). 1st distinct report: reporter-only banner; 2nd distinct report (default threshold): stream auto-stops for moderation.
4) Feed check
(Grouped feed result will appear here.)
Live Playground
Mobile-style live + circle + chat. Click only — no stream-id paste. Use 2 browsers to test SignalR LiveStreamChatRoomReady.
Tap a host to join. Login first. Connects SignalR + Chat automatically.
Sentry Test
Trigger a test exception to verify Sentry is capturing errors.
This calls GET /api/SentryTest/throw which throws an exception. You should see a 500 response here and the error in your Sentry dashboard.
Apple IAP config diagnostics (Admin only). Calls GET /api/Credits/debug/apple-config.
Day-wise Logs
List backend rolling logs, view latest lines, and download by day.
Reads all files from backend Logs folder. View opens full file content and download saves full file.
(Select a log file to view.)
Welcome
Sign in to access the tester dashboard.
Step 1 sends OTP to email. Enter it in Step 2, then set password in Step 3.
Docs
Module-wise documentation viewer (Markdown).
Profile
Get or update your profile: name, email (read-only), gender, dashcam type, profile picture. Login required.
My Circle
Search or browse users and tap + to add them to your circle. Uses GET /api/users/search and /api/circles.
Or add/remove by user ID manually:
Change password
Set a new password (requires current password). Login required.
Videos
Test video upload modes: Direct-to-Azure (recommended) and Legacy API modes. Login required.
Chunked upload: use Direct-to-Azure (recommended) or Legacy API-proxied chunks (older POC). Thumbnail is optional on complete for these chunked flows.
Load my videos = everyone's videos. My Feed = only your videos (with views, shares, average rating). Use Play (MP4) to play immediately; Play (HLS) appears after background encoding (refresh after 1–2 min). Validation uses 1/2/5 tiers, and in rating-batch mode you send 4 previous IDs while current URL video is the 5th.
Home map search
Calls GET /api/map/search?query=.... It returns both metadata search matches and Google location-based matches, including isGoogleLocationResult and fallback lat/lng when no nearby video is found.
(Map search results will appear here.)
ML manual bearer token (optional)
If provided, this token is used for GET /api/videos/nearby and POST /api/webhooks/video-analysis. If empty, UI uses your login token.
Nearby analysis lookup
Calls GET /api/videos/nearby with latitude, longitude, timestamp, radius and time_range to verify ML analysis records.
(Nearby analysis results will appear here.)
AI/ML callback webhook tester
Calls POST /api/webhooks/video-analysis with required Authorization: Bearer and X-Job-ID header.
Rate Testing
Rate-focused testing for milestone progress, owner visibility, and full validation payloads.
Use this tab to test rating flow quickly without scrolling the full Videos section.
(Candidate list with owner details will appear here.)
Valid Videos Rate
Only valid videos (not expired, not deleted) that you can rate. Rate directly from tile and verify confidence score update.
This uses GET /api/videos/videos-left-to-rate and shows confidence score, average rating, and per-user rating entries for each tile.
Notifications (v1)
Register device token, list notifications, unread count, mark read, and send admin test push.
1) Register Device
Calls POST /api/v1/devices. Login required.
2) List Notifications
Calls GET /api/v1/notifications. Use filters as needed.
(Notifications list will appear here.)
3) Mark as Read
4) Test Push (Admin)
Calls POST /api/v1/notifications/test-push. Admin JWT required.
5) Admin Simulation Helpers
Admin-only helper actions to quickly test the 2 enabled admin auto-notification flows.
6) Request Live — test bench (all results on this page)
Single window: log in as target → Use my user ID → Connect hub → Run full test. Two windows: target connects hub in window A; sender uses target Guid in window B.
Logged-in user: —
(Presence and send responses appear here.)
(Connect hub as the target user; events show here when delivery works.)
AI/ML Reprocess
Select videos and submit to AI/ML through backend so ML job id is persisted on video.
Loads your videos from backend and calls backend endpoint POST /api/videos/{id}/ml/submit for selected videos.
Credits & Buy Credits
View balance, packages, and create a Stripe payment intent to buy credits. Login required for overview and purchase.
Select a package and create a payment intent. Use the returned clientSecret with Stripe.js (or test with Stripe test card 4242 4242 4242 4242). After payment, webhook adds credits.
Verify IAP purchase (Apple / Google)
Login required. This calls POST /api/credits/verify-purchase.
Transaction history (last 30 days).
Subscriptions
Browse plans, activate via IAP, cancel, and re-subscribe after cancel. Admin: full plan management. Login required.
1) Browse Plans
Calls GET /api/subscriptions/plans with the platform selected above. Select a card to auto-fill the activation form below.
2) Activate / Re-subscribe (IAP)
Calls POST /api/subscriptions. Paste the receipt / purchase token from the device store. Plan ID and platform auto-fill when you select a plan card above.
After cancel: complete a new store purchase — do not reuse the old token. The backend expires the cancelled subscription when the new one activates.
iOS — synced from Store platform above
3) My Active Subscription
Calls GET /api/subscriptions/me. Returns active, past-due, or cancelled-pending-expiry subscription. 404 if none.
4) Cancel Subscription
Calls DELETE /api/subscriptions/{id}. Stops auto-renewal — status becomes cancelled and access stays until expiryDate. Tokens are NOT removed. You can re-subscribe immediately with a new IAP token (section 2).
5) Change Plan (Upgrade / Downgrade)
Calls PATCH /api/subscriptions/{id}. Upgrade = immediate, requires new IAP token. Downgrade = deferred to period end, no token needed. Click a plan card above to auto-fill New Plan ID.
iOS — synced from Store platform above
6) Payment History
Calls GET /api/subscriptions/payments?limit=&offset=. Returns paginated list of all payments. Click a row to auto-fill the Receipt ID below.
(Click "Load Payment History" to fetch.)
7) Payment Receipt
Calls GET /api/subscriptions/payments/{id}. Returns receipt details for a single payment. Auto-fills from the first result in Payment History above.
8) Subscription History
Calls GET /api/subscriptions/me/history. Returns all past and current subscription records for the logged-in user.
(Click "Load Subscription History" to fetch.)
Admin JWT required. All plan changes are audit-logged (before/after JSON). A plan with active subscribers cannot be deleted — deactivate it instead.
(Click "Load All Plans" to fetch.)
Create / Update Plan
Leave plan selector empty → Create. Select a plan → fields auto-fill for Update.
Phase 4 — Revenue Dashboard
Calls GET /api/admin/subscriptions/revenue. Returns all-time & monthly revenue totals plus per-plan breakdown.
(Click "Load Revenue" to fetch.)
Subscriber Analytics
Calls GET /api/admin/subscriptions/analytics. Returns subscriber counts, status breakdown, and plan distribution.
(Click "Load Analytics" to fetch.)
Phase 5 — Subscription Reconciliation
Calls POST /api/admin/subscriptions/reconcile. Finds Active subscriptions whose billing period elapsed without a renewal webhook and marks them PastDue. The reconciliation job also runs automatically every 6 hours.
Account Lifecycle Hooks
Suspend / Resume / Delete lifecycle hooks. These are typically triggered by the user management system, not called directly, but can be tested here.
Admin – Credits
For Admin users only. Manage base price per credit and credit packages.
You must be logged in as an Admin (UserRole.Admin) for these calls to succeed.
Base price per credit
Packages
(Packages will appear here.)
Create or update a package below, then click the corresponding button.
Admin — What can report review do? (tap to expand)
Video: Allow = content OK. Remove = take down (+ optional block user).
Live: 1 report auto-ends stream → admin reviews. Approve = short playback (~48h). Reject = remove. Force stop = end while still live.
List: GET /api/admin/reported-content (video + live).
Reported content (video + live)
Click any tile → POST /api/admin/video-reports/by-ids (uses session/video GUID; report id optional for live).
All: — | Pending: — | Allowed: — | Removed: —
Admin - Dev Users
Search a user, add them to the dev list, or remove them. Login and profile return isDevUser: true when the logged-in user's full name is in this list.
Admin only. Search uses GET /api/admin/users (includes you). Add uses POST /api/admin/dev-users. Delete uses DELETE /api/admin/dev-users/{id}. The match is the user's current first + last name, ignoring case.
Dev user list
Admin - Users
For Admin users only. List users sorted by active first and newest created.
Calls /api/admin/users with paging/search. Use checkboxes for bulk activate/deactivate via PATCH /api/admin/users/status.
(Users will appear here.)
Admin – Report Schedules
For Admin users only. Test and configure the system performance report email.
You must be logged in as an Admin (UserRole.Admin) for these calls to succeed.
⚡ Quick test send
Sends (or previews) a real report right now — no schedule needs to be created first. Use this to just check what the email looks like.
⚙️ Advanced: manage recurring schedules (tap to expand)
Only needed to set up the real automated recurring email (e.g. every day at 9am). For just testing the report, use Quick test send above instead. Multiple schedules can be active at once (e.g. Daily + Weekly + Monthly), each with its own time/day/recipients.
Schedules
(Schedules will appear here.)
Create or update a schedule below, then click the corresponding button.
No schedule selected — fields below will create a new schedule.
Send now: immediately sends the selected saved schedule's report email for its current window — ignores day/time due-check.
Refresh Token
Get new tokens (uses saved refresh token).
Logout
Sign out (uses current token).
Scan Mode
Test POST /api/v1/heartbeat and GET /api/scanmode/online-users. Login required. Presence TTL is 6 minutes — send heartbeat every 5 min to stay online.
Two-device test: open this tab on two browsers with different users, same coordinates. Always await heartbeat before Get online users (or use the combined button).
1) Heartbeat
Type latitude, longitude, and altitude manually below, then send. Browser GPS is optional — it only fills these fields (you can edit before send).
Manual coordinates
2) Online users (500 m)
Calls GET /api/scanmode/online-users. Returns nearby online users except you. Empty [] is valid when nobody else is within 500 m.
(Nearby online users will appear here.)
Quests — Treasure Hunt
Create, activate, find, and manage treasure-hunt quests. Login required for all endpoints.
1) Create Quest — Free & Premium
POST /api/v1/quests · sent as multipart/form-data — Server derives tier, reward tokens and premium cost from the chosen icon. FREE Standard icons cost nothing. PREMIUM icons deduct PremiumCostTokens from your balance when the quest goes Active (drain order: Daily → Earned → QuestEarned → Purchased). Click Load Icons from API first.
questImage multipart file part.
AR / positioning fields (optional)
2) Quest Actions (uses Quest ID above)
All three use the Quest ID field at the top of this section. Activate a Premium quest deducts its PremiumCostTokens from your balance (drain order: Daily → Earned → QuestEarned → Purchased); returns 402 if you can't afford it. Cancel fails with 409 once any finder has collected. Create Share Link calls POST /api/v1/quests/{id}/share-score — same (quest, sharer) combo returns the previously-minted link for 30 days instead of a fresh one.
(Quest detail will appear here.)
3) Find (Collect) Quest
POST /api/v1/quests/{id}/find — Server haversine proximity check. Your coordinates must be within CollectionRadiusMeters of the quest. Rewards tokens to finder and writes a QuestFinding + UserTreasure record.
Tip: set your coords very close to the quest coords above to pass the proximity check in testing.
4) Participant Management
Track an active play session for the quest in the Quest ID field above. A user can only be active in one quest at a time. Start is rejected if you are outside quest_participant_radius_meters (default 2 km). Send Heartbeat calls the unified POST /api/v1/heartbeat with questId — the separate participant heartbeat endpoint has been removed.
(Participants list will appear here.)
5) Discovery — Live Map
Map auto-fetches GET /api/v1/quests/viewport on every pan/zoom (debounced 600 ms). Click a marker to select it — fills the Quest ID above and shows details. Color: ● Standard ● Premium ● Inactive.
Random quest in viewport
Calls GET /api/v1/quests/viewport/random using the four bounding-box coordinates above. Returns a list containing 0 or 1 quest, excluding quests you created. Prefers a quest at least ~2 km from the viewport center (offset left/right / ahead/behind), not dead-center.
Nearby quests (radius search)
My quests & treasures
(My quests / treasures will appear here.)
Quests at an event
6) Puzzle State (v2 — not yet active)
GET /api/v1/quests/me/puzzle — Returns your current treasure-icon puzzle slots and completion status.
7) Generate Quest Near Me (UC-7)
POST /api/v1/quests/generate — System creates a Standard quest near your coordinates using AI-selected icon. Only 1 active generated quest per user at a time (409 if one already exists).
8) Admin — Batch Create Quests
POST /api/admin/quests/batch — Admin role required. Scatters quests randomly inside a venue / event geofence polygon and activates them immediately (system-funded).
(Batch create result will appear here.)
9) Admin — Auto-Generate Quests from City Place
POST /api/admin/quests/auto-generate-from-city-place — Admin role required. Uses Google Places API to find top POIs in a city and auto-generates quests at walkable street coordinates near each place.
(Auto-generate result will appear here.)
Promotions — Wallet, Create & Discover
Fund the Promotion Wallet, walk a Draft through the Create wizard (Boost / Offer / Repeat), publish it (with a deferred card payment if the wallet is short), discover & claim offers, and redeem vouchers as a merchant. Login required.
Stripe billing details (used for every card payment below)
This Stripe account requires a cardholder name + billing address on every payment (India cross-border export rule) — otherwise you'll see "export transactions require a customer name and address". Defaults are pre-filled; edit if you like.
Promotion Wallet
GET /api/v1/promotion-wallet — cash funds Boost Visibility & deferred publish/boost charges; vouchers fund Offers.
Add Funds
POST /promotion-wallet/cash-top-up-intent, then confirm the card — same Stripe Elements pattern as Credits.
Test card: 4242 4242 4242 4242. Cash balance updates after the Stripe webhook lands — click "Refresh wallet" a couple seconds after paying.
Buy Vouchers
GET /promotion-wallet/voucher-packages (no login needed to browse), then POST .../purchase-intent.
Test card: 4242 4242 4242 4242. Voucher balance updates after the webhook lands — click "Refresh wallet" a couple seconds after paying.
My Saved Voucher Packages
Buy Cash Package (Native In-App Purchase)
Alongside Stripe "Add Funds" above, not a replacement. GET /promotion-wallet/cash-packages?platform=ios|android (no login needed to browse), then POST /promotion-wallet/cash-topup/verify-purchase with a receipt/transaction token from the store — no card entry, no webhook wait, credits cashBalance synchronously in the same response.
Recent Activity
GET /promotion-wallet/transactions — newest first.
Create Promotion
Step 1 of 3. POST /api/v1/promotions {name, imageUrl} creates a Draft. Image uploads via POST /api/v1/promotions/image-upload first (done automatically here if you pick a file and click Create Draft).
Step 2 of 3 — Enhance & Configure (Draft)
PATCH /api/v1/promotions/{id} — patch-style, only the fields you send change. boost*/repeat* fields are Draft-only (400 once Active).
Map — Location & Nearby
🔴 Red pin = your create location (click map or drag pin). 🟣 Purple markers = nearby promotions. Click a marker to view details.
boostVisibilityCostPerDayUsd from config.Boost Visibility
How long do you want the spotlight to run?
PUT {id}/offer. Toggle off → DELETE {id}/offer (idempotent, no confirmation).Add an Offer
repeatEnabled/repeatFrequency/… via PATCH.Repeat Promotion
Your Promotion Wallet is charged when it runs. We'll let you know when it's time to top up.
Add to Quest Map
Choose Free or Premium, then how many days it stays on the map.
Step 3 of 3 — Preview & Publish
Test card: 4242 4242 4242 4242. Nothing is deducted and the promotion stays Draft until this payment succeeds — Boost/Quest Map/Offer (incl. any auto-selected voucher pack) all apply together, atomically, once the webhook lands. This auto-refreshes the detail below a few seconds after a successful payment.
Promotion Detail
Note: Record View never counts while you're logged in as this promotion's creator — log in as a different user to test it, or it won't increment (this is expected, not a bug).
Creator Tools (Post-Publish)
Manage Changes — Bundled Preview & Publish
Combine a Boost Visibility change, a Quest Map placement, an Offer top-up, and/or enabling Repeat into ONE request — mirrors the Create flow's Step 3 for the Boost/Quest Map cash total. Offer top-up (voucher-funded, best-effort) and Repeat (free, applies immediately) ride along but never affect the cash preview/charge above (see docs §9).
Test card: 4242 4242 4242 4242. Changes apply once the webhook lands — this auto-refreshes the detail below a few seconds after a successful payment.
Adjust the current Quest Map placement. Days and Vouchers are NEW TOTALS, not deltas — treasure/tier isn't editable here (use Remove + Add for that). Shrinking Days is free (no refund); growing Days charges only the additional days. Shrinking Vouchers (Premium only) refunds the unclaimed slots to your wallet's voucher balance; growing Vouchers charges only the additional slots.
Places this promotion on the Quest map, funded from wallet cash. Premium also funds redeemable vouchers — 1 voucher = 1 quest finder, same as "Add an Offer", redeemable in-store.
Test card: 4242 4242 4242 4242. The top-up applies once the webhook lands — this auto-refreshes the detail below a few seconds after a successful payment.
Edit Promotion
PATCH /api/v1/promotions/{id} — Active promotions only. Location cannot be changed in v1.
(Promotion detail JSON will appear here.)
My Promotions
GET /api/v1/promotions/mine — Profile → My Promotions list with status badges, view counts, and end dates.
Merchant — Scan Voucher Code
Stand-in for scanning a customer's redemption QR with a camera — this is a browser test tool, so just paste/type the code. Uses the merchant's own token (must be the promotion's creator). POST /api/v1/promotion-redemptions/scan
Saved Promotions
GET /api/v1/promotions/saved
Are you sure?
Promotions — Discover & Claim (Consumer)
The "normal user" side, separate from the Promoter tab: browse what's nearby, open a promotion, and claim its Offer for a redemption code — no promotion creation involved. Log in as a different account than the promoter to test this end-to-end. Login required.
Discover Nearby Promotions
Calls GET /promotions/nearby directly.
📍 Pin = your search location (click map or drag pin). 📣 Markers = the promoter's nearby promotions. Click a marker (or its "View detail" popup button) to open it below.
Promotion Detail
My Saved Promotions
My Valid Vouchers
Vouchers you've claimed that are still usable — excludes anything already redeemed in-store, and anything whose promotion has expired/been cancelled.
Quest V1 Live Stream
Follow steps in order: location → viewport quests → participant → hub → live/join. Or use Run all steps.
Set lat/lng first — used for viewport quest search and Start Play radius check.
Calls GET /api/v1/quests/viewport using your Step 1 lat/lng + radius (not the Quests tab defaults). Click a card or dropdown.
API: —
GET /api/v1/quest-live-streams/discover — grouped by location → host → stream. No quest participation needed to join.
🔴 Map — live hosts appear as nodes. Pin moves when host sends heartbeat. Click node for details → Join / Leave.
POST …/participants/start — must be within 2km of the quest pin, not just your Step 1 location.
Select a quest — distance to quest pin will show here.
/hubs/quest-live-stream — real-time join/leave/end events.
SubscribeToQuest — receive QuestLiveStreamStarted on this quest.
POST …/live-streams — starts stream; you become host participant in stream.
Pick a stream from the map (Step 2) or list below, then Join / Leave.
After start/join: circle updates in the Participants monitor (right).
Host taps Remove on a viewer to kick · SignalR QuestLiveStreamParticipantRemoved
→ viewer gets removedByHost: true (rejoin blocked).
Backend creates chatRoomId on start (no PATCH).
Advanced kick (paste userId)
- After join/start — click Refresh participants.
(Events appear after hub connect.)
Advanced — manual REST
Street Locations
Preview real walkable street coordinates near any point. Calls GET /api/admin/quests/street-locations via Google Roads API and pins each result on the map.
Enter a centre coordinate, choose a search radius (up to 5 km) and how many points to return (1–50). Click Fetch Locations — markers appear on the map below. Click any marker for its coordinates and Place ID.
Events Map (App Viewport)
Load live map events from GET /api/events (viewport, ±12h). Search catalog via /api/events/search. Sources: Ticketmaster, ESPN, PredictHQ — multi-country via EventIngestion:SupportedCountryCodes.
Viewport events first — pan/zoom to refresh
Uses GET /api/events?SouthWestLatitude=…&SouthWestLongitude=…&NorthEastLatitude=…&NorthEastLongitude=… (±12h window). Green = onGoing, blue = upcoming. PredictHQ events may have no ticket/image URL.
Country support (multi-market ingestion)
Dev config seeds Ticketmaster {CC} + PredictHQ {CC} per country.
Prod/UAT typically US only. Click a country to jump the map, set filters, and load viewport events.
Event ingestion (Admin)
Manage Ticketmaster, ESPN, and PredictHQ sync via GET/POST /api/admin/event-sources.
One row per country (e.g. PredictHQ IN, Ticketmaster GB) when
SupportedCountryCodes includes that market. PredictHQ trial is global (no API country cap);
SeeCircles limits ingest via config. Token: Key Vault PredictHQ--ApiToken.
Event cards
Raw response
Popup Stores
Share & save for Popup Stores and their curated Shop Products (StoreItem). Browse via GET /api/v1/popup-stores/nearby and GET /api/v1/popup-stores/{id} elsewhere; this panel focuses on the new share/save endpoints.
Popup Store
Shop Product (StoreItem)
A single curated product inside a Popup Store. Share only — there is no save/unsave for Shop Products.
My Saved Popup Stores
Saved Bookmarks
The "Saved" screen's tabbed bookmark list — aggregates Events / Shops / Offers / Vouchers / Videos in one call. Saving/unsaving itself lives on each resource's own module (Events Map, Popup Stores, Videos, Promotions) — this panel is read-only aggregation across all of them.
Bookmarks List
GET /api/v1/bookmarks?tab=&search=&sort=&latitude=&longitude=
Voucher rows (itemType: "voucher", in both this list and the
history below) now also carry promotionId (the underlying Promotion, for
detail navigation) and claimId (same value as the row's own id,
named explicitly so it's unambiguous per-tab). Paste a promotionId into the
box below to jump straight to its detail in Promotions (Consumer).
Offer/Voucher cards are clickable — jumps straight to that promotion's detail in Promotions (Consumer), same as pasting its id below.
Ended Offers
GET /api/v1/bookmarks/offers/ended?search= — saved promotions that dropped out of the Offers tab above: past their own end date, or otherwise no longer Active (cancelled/draft). Unlike Vouchers, there's no Used/Expired split — just one flat "ended" list, most recently ended first.
Used & Expired Vouchers
GET /api/v1/bookmarks/vouchers/history?search= — claimed vouchers that are no longer active, split into Used (redeemed in-store) and Expired (promotion ended, never redeemed). "Vouchers" here means a claimed PromotionOfferClaim (a QR code the user redeems in-store) — not the purchasable VoucherPackage from the Promotion Wallet module, which is a separate, unrelated bookmark type. Rows here also carry promotionId/claimId — paste a promotionId into the box above to open it.
Used
Expired
Chat (Agora)
Interactive DM chat — conversations, send/receive, typing indicator. Auto-connects after login.
⚙️ API Tools — Token, Raw Search, Peer Profile
Chat Tokens from Login
Populated automatically after login. Used by Connect above.
GET /api/chat/token
Returns a fresh Agora Chat token. Login required.
POST /api/chat/token/refresh
Issues a new token (SDK expiry callback path). Login required.
GET /api/users/search
Optional q (min 3 chars if set; blank = all users). Paginated via page / pageSize (max 50). Response data.users + totalCount, currentPage, totalPages. Use agoraChatUserId for Agora.
GET /api/users/{id}/chat-profile
Returns isActive — used to show the deactivated banner.
Or paste a Google ID token:
Paste Firebase ID token after Apple sign-in via Firebase Auth.
Paste a Firebase ID token from your app (e.g.
user.getIdToken()).