v1.4 stable
API Reference
Full REST + WebSocket surface for partners and integrations. All endpoints accept JSON and return JSON.
Auth
POST
/v1/auth/loginIssue session token.
POST
/v1/auth/logoutInvalidate current session.
POST
/v1/auth/refreshRotate refresh token.
GET
/v1/auth/meReturn current user profile.
Listings
GET
/v1/listingsList + filter marketplace listings.
POST
/v1/listingsCreate a new listing.
GET
/v1/listings/{id}Fetch a single listing.
PATCH
/v1/listings/{id}Update fields.
DELETE
/v1/listings/{id}Remove a listing.
POST
/v1/listings/{id}/featurePromote to featured (Pro+).
Trades
POST
/v1/tradesPropose a new trade.
GET
/v1/tradesList trades for current user.
POST
/v1/trades/{id}/acceptAccept proposal.
POST
/v1/trades/{id}/declineDecline proposal.
POST
/v1/trades/{id}/completeMark fulfilled.
AI
POST
/v1/ai/searchSmart search with intent ranking.
GET
/v1/ai/matchesPersonalised trade suggestions.
POST
/v1/ai/chatSend a message to the support bot.
Messaging
GET
/v1/threadsList conversation threads.
GET
/v1/threads/{id}/messagesFetch messages.
POST
/v1/threads/{id}/messagesSend a message.
WS
/v1/ws/messagesRealtime message stream.
Payments
POST
/v1/billing/checkoutStart Stripe checkout session.
POST
/v1/billing/portalOpen customer portal.
POST
/v1/billing/webhookStripe webhook receiver.
Admin
GET
/v1/admin/usersList & moderate users.
POST
/v1/admin/users/{id}/banSuspend a user.
GET
/v1/admin/metricsPlatform KPIs.
