v1.4 stable

API Reference

Full REST + WebSocket surface for partners and integrations. All endpoints accept JSON and return JSON.

Auth
POST
/v1/auth/login

Issue session token.

POST
/v1/auth/logout

Invalidate current session.

POST
/v1/auth/refresh

Rotate refresh token.

GET
/v1/auth/me

Return current user profile.

Listings
GET
/v1/listings

List + filter marketplace listings.

POST
/v1/listings

Create 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}/feature

Promote to featured (Pro+).

Trades
POST
/v1/trades

Propose a new trade.

GET
/v1/trades

List trades for current user.

POST
/v1/trades/{id}/accept

Accept proposal.

POST
/v1/trades/{id}/decline

Decline proposal.

POST
/v1/trades/{id}/complete

Mark fulfilled.

AI
POST
/v1/ai/search

Smart search with intent ranking.

GET
/v1/ai/matches

Personalised trade suggestions.

POST
/v1/ai/chat

Send a message to the support bot.

Messaging
GET
/v1/threads

List conversation threads.

GET
/v1/threads/{id}/messages

Fetch messages.

POST
/v1/threads/{id}/messages

Send a message.

WS
/v1/ws/messages

Realtime message stream.

Payments
POST
/v1/billing/checkout

Start Stripe checkout session.

POST
/v1/billing/portal

Open customer portal.

POST
/v1/billing/webhook

Stripe webhook receiver.

Admin
GET
/v1/admin/users

List & moderate users.

POST
/v1/admin/users/{id}/ban

Suspend a user.

GET
/v1/admin/metrics

Platform KPIs.