// docs

MarketSDK documentation

A REST API for the marketplace inside your product: sellers, listings, search, orders, payments on your own Stripe account, reputation, disputes, and moderation. You call it from your server; your users never see us.

GET /v1/marketplaceyour first call

curl https://api.marketsdk.com/v1/marketplace \
  -H "Authorization: Bearer $MARKETSDK_KEY"
# a test key starts msk_test_sk_. Make one in the dashboard, under api keys.

Guides

Quickstart
A test key, a seller, a listing, and an order, in ten minutes.
Authentication
Secret and publishable keys, test and live, and allowed origins.
Errors
One envelope for every error, and the codes worth handling.
Pagination
Cursor lists, newest first.
Idempotency and rate limits
Safe retries, and what to do on a 429.
Orders
The state machine, who may act, and the timers.
Reputation
Events, counts, and the default score.
Payments and payouts
Checkout, the platform fee, release, refunds, and verification.
Connecting Stripe
The restricted key, and each permission it needs.
Disputes and moderation
Evidence, decisions, flags, and actions.
Webhooks
Events, signatures, retries, and replay.
Test and live
Two marketplaces that never share data.

API reference

Generated from the OpenAPI description the API publishes at https://api.marketsdk.com/v1/openapi.json, so it always matches what the API does.

Contact

Questions, and anything that looks wrong in these pages: hello@marketsdk.com. Quote the request_id of any call you ask about.

To report abuse by a marketplace built on MarketSDK: report@marketsdk.com.