// api reference
API reference
Every endpoint, generated from the OpenAPI description the API publishes at https://api.marketsdk.com/v1/openapi.json. Version v1. Base URL https://api.marketsdk.com/v1.
A headless API for a peer-to-peer marketplace inside your product.
Authenticate with Authorization: Bearer <api key>. The key alone decides the marketplace and the mode: msk_test_ keys reach test mode, msk_live_ keys live mode, and data never crosses.
Every POST accepts Idempotency-Key; a repeat within 24 hours returns the original response. Lists are cursor-based. Money is integer minor units with an ISO currency code. Timestamps are ISO 8601 in UTC. Errors share one envelope with a request_id.
Abuse reports: report@marketsdk.com.
Marketplace
Sellers
Buyers
Categories
Listings
- GETList listings, newest first
- POSTCreate a listing, as a draft
- POSTCreate up to 100 listings at once, all or none
- GETRetrieve a listing
- PATCHUpdate a listing
- POSTPublish a listing
- POSTReturn a published listing to draft
- POSTTake a listing down, with a reason
- GETA listing's media, pending uploads included
- POSTStart a media upload
- POSTComplete a media upload
- DELETEDelete media and its file
Search
Orders
- GETList orders, newest first
- POSTCreate an order
- GETRetrieve an order
- GETAn order's transitions, oldest first
- POSTClaim the deal is done (committed to claimed)
- POSTConfirm a claim (claimed to completed), by the party who did not claim
- POSTBack out (committed to cancelled)
- POSTPropose cancelling by agreement
- POSTAccept a proposal to cancel (committed to cancelled, reason mutual)
- POSTDecline a proposal to cancel. The order stays committed.
- GETAn order's reviews
- POSTReview the other party
Reviews
Reputation
Payments
Trust
- POSTStart a seller's identity verification
- GETList identity verifications, newest first
- GETRetrieve an identity verification
- POSTCancel a verification the seller has not submitted
- GETList disputes, newest first
- GETRetrieve a dispute
- GETA dispute's evidence, oldest first
- POSTAdd evidence from one side
- POSTEnd the evidence stage early
- POSTDecide a dispute
- POSTDispute an order
Moderation
Webhooks
- GETList webhook endpoints
- POSTRegister a webhook endpoint
- GETRetrieve a webhook endpoint
- PATCHUpdate a webhook endpoint, or turn it off and on
- DELETEDelete a webhook endpoint and its deliveries
- POSTReplace the signing secret
- GETRecent deliveries, newest first, with request and response
- GETRetrieve a delivery
- POSTSend a delivery again
- GETEvents, newest first: every state change on every resource
- GETRetrieve an event