{"components":{"schemas":{"Category":{"additionalProperties":false,"properties":{"categoryPath":{"type":"string"},"count":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"label":{"type":"string"}},"required":["categoryPath","label","count"],"type":"object"},"CreateListingRequest":{"additionalProperties":false,"properties":{"attributes":{"$ref":"#/components/schemas/JsonValue"},"categoryPath":{"description":"Slash-delimited lowercase taxonomy path, e.g. \"electronics/cameras\" — never an external marketplace's numeric category id. Defaults to \"general\".","pattern":"^[a-z0-9]+(?:[-/][a-z0-9]+)*$","type":"string"},"checkoutEnabled":{"type":"boolean"},"condition":{"description":"Defaults to \"good\".","enum":["new","refurbished","like_new","good","fair","for_parts"],"type":"string"},"currency":{"description":"ISO 4217 code. Defaults to the platform default currency.","maxLength":3,"minLength":3,"type":"string"},"description":{"type":"string"},"directEnabled":{"type":"boolean"},"inventoryType":{"description":"Defaults to \"unique\".","enum":["unique","multi_qty"],"type":"string"},"location":{"$ref":"#/components/schemas/GeoLocation"},"madeInCountry":{"anyOf":[{"maxLength":2,"minLength":2,"type":"string"},{"type":"null"}],"description":"Country of manufacture as an ISO 3166-1 alpha-2 code (e.g. CA, DE), stored uppercase; null when not specified. Used as the item's origin country on international shipping labels (customs and duties). A lowercase code is accepted and uppercased; an unknown code is rejected. On an update, null clears it and omitting the field leaves it unchanged."},"pickupEnabled":{"type":"boolean"},"price":{"description":"Integer minor units of `currency` (e.g. cents for USD).","maximum":9007199254740991,"minimum":0,"type":"integer"},"quantityTotal":{"description":"Defaults to 1.","exclusiveMinimum":0,"maximum":9007199254740991,"type":"integer"},"riskCategory":{"description":"Defaults to \"general\".","enum":["general","phone","tablet","luxury","collectible","high_end_electronics"],"type":"string"},"shippingEnabled":{"type":"boolean"},"shippingFlatAmount":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Integer minor units. Must be greater than 0 before a shipping-enabled listing can be published."},"shippingProfileId":{"type":["string","null"]},"title":{"maxLength":200,"minLength":1,"type":"string"},"visibilityRadiusKm":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]}},"required":["title","description","price"],"type":"object"},"Error":{"additionalProperties":false,"properties":{"code":{"type":"string"},"error":{"type":"string"}},"required":["error"],"type":"object"},"GeoLocation":{"additionalProperties":false,"properties":{"addressLine1":{"type":"string"},"addressLine2":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"latitude":{"maximum":90,"minimum":-90,"type":"number"},"longitude":{"maximum":180,"minimum":-180,"type":"number"},"postalCode":{"type":"string"},"region":{"type":"string"}},"required":["country"],"type":"object"},"IsoDateTime":{"format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","type":"string"},"JsonValue":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"items":{"$ref":"#/components/schemas/JsonValue"},"type":"array"},{"additionalProperties":{"$ref":"#/components/schemas/JsonValue"},"propertyNames":{"type":"string"},"type":"object"}]},"ListCategoriesResponse":{"additionalProperties":false,"properties":{"categories":{"items":{"$ref":"#/components/schemas/Category"},"type":"array"}},"required":["categories"],"type":"object"},"ListListingsResponse":{"additionalProperties":false,"properties":{"hasMore":{"type":"boolean"},"limit":{"maximum":100,"minimum":1,"type":"integer"},"listings":{"items":{"$ref":"#/components/schemas/Listing"},"type":"array"},"offset":{"maximum":9007199254740991,"minimum":0,"type":"integer"}},"required":["listings","limit","offset","hasMore"],"type":"object"},"ListOrdersResponse":{"additionalProperties":false,"properties":{"hasMore":{"type":"boolean"},"limit":{"maximum":100,"minimum":1,"type":"integer"},"offset":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"orders":{"items":{"$ref":"#/components/schemas/Order"},"type":"array"}},"required":["orders","limit","offset","hasMore"],"type":"object"},"Listing":{"additionalProperties":false,"properties":{"acceptsOffers":{"type":"boolean"},"attributes":{"$ref":"#/components/schemas/JsonValue"},"authority":{"enum":["MARKA","EBAY","ETSY","SHOPIFY"],"type":"string"},"autoAcceptOfferAmount":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Offers at or above this amount are auto-accepted. Integer minor units."},"brand":{"type":["string","null"]},"categoryPath":{"type":"string"},"checkoutEnabled":{"description":"Available on the CHECKOUT rail (Stripe Connect payment).","type":"boolean"},"condition":{"enum":["new","refurbished","like_new","good","fair","for_parts"],"type":"string"},"createdAt":{"$ref":"#/components/schemas/IsoDateTime"},"currency":{"description":"ISO 4217 currency code.","type":"string"},"description":{"type":"string"},"directEnabled":{"description":"Available on the DIRECT rail (in-person pickup, no Stripe).","type":"boolean"},"gtin":{"description":"UPC, EAN, ISBN or other GTIN — digits only.","type":["string","null"]},"id":{"type":"string"},"imageUrls":{"items":{"type":"string"},"type":"array"},"inventoryType":{"enum":["unique","multi_qty"],"type":"string"},"location":{"$ref":"#/components/schemas/GeoLocation"},"madeInCountry":{"description":"Country of manufacture as an ISO 3166-1 alpha-2 code (e.g. CA, DE), stored uppercase; null when not specified. Used as the item's origin country on international shipping labels (customs and duties).","type":["string","null"]},"packageDimensionsMm":{"anyOf":[{"$ref":"#/components/schemas/PackageDimensionsMm"},{"type":"null"}]},"packageWeightGrams":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}]},"pickupEnabled":{"type":"boolean"},"price":{"description":"Integer minor units of `currency` (e.g. cents for USD).","maximum":9007199254740991,"minimum":0,"type":"integer"},"quantityReserved":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"quantityTotal":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"riskCategory":{"enum":["general","phone","tablet","luxury","collectible","high_end_electronics"],"type":"string"},"sellerAccountId":{"type":"string"},"shippingEnabled":{"type":"boolean"},"shippingFlatAmount":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Flat per-order shipping charged at checkout. Integer minor units of `currency`."},"shippingProfileId":{"type":["string","null"]},"status":{"enum":["draft","active","reserved","sold","paused","removed"],"type":"string"},"title":{"type":"string"},"updatedAt":{"$ref":"#/components/schemas/IsoDateTime"},"visibilityRadiusKm":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]}},"required":["id","sellerAccountId","authority","status","inventoryType","quantityTotal","quantityReserved","categoryPath","condition","title","description","attributes","imageUrls","brand","gtin","packageWeightGrams","packageDimensionsMm","madeInCountry","acceptsOffers","autoAcceptOfferAmount","price","currency","location","pickupEnabled","shippingEnabled","shippingProfileId","shippingFlatAmount","directEnabled","checkoutEnabled","visibilityRadiusKm","riskCategory","createdAt","updatedAt"],"type":"object"},"ListingResponse":{"additionalProperties":false,"properties":{"listing":{"$ref":"#/components/schemas/Listing"}},"required":["listing"],"type":"object"},"ListingSummary":{"additionalProperties":false,"properties":{"categoryPath":{"type":"string"},"condition":{"enum":["new","refurbished","like_new","good","fair","for_parts"],"type":"string"},"createdAt":{"$ref":"#/components/schemas/IsoDateTime"},"currency":{"description":"ISO 4217 currency code.","type":"string"},"id":{"type":"string"},"imageUrls":{"items":{"type":"string"},"type":"array"},"location":{"$ref":"#/components/schemas/GeoLocation"},"pickupEnabled":{"type":"boolean"},"price":{"description":"Integer minor units of `currency` (e.g. cents for USD).","maximum":9007199254740991,"minimum":0,"type":"integer"},"sellerAccountId":{"type":"string"},"shippingEnabled":{"type":"boolean"},"title":{"type":"string"}},"required":["id","sellerAccountId","title","categoryPath","condition","price","currency","imageUrls","pickupEnabled","shippingEnabled","location","createdAt"],"type":"object"},"MeResponse":{"additionalProperties":false,"properties":{"plan":{"$ref":"#/components/schemas/Plan"},"user":{"$ref":"#/components/schemas/User"}},"required":["user","plan"],"type":"object"},"MoneyBreakdown":{"additionalProperties":false,"properties":{"applicationFeeAmount":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"currency":{"type":"string"},"itemSubtotal":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"shippingAmount":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"taxAmount":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["itemSubtotal","shippingAmount","taxAmount","applicationFeeAmount","currency"],"type":"object"},"Order":{"additionalProperties":false,"properties":{"buyerId":{"type":"string"},"checkoutShippingDetails":{"anyOf":[{"additionalProperties":false,"properties":{"address":{"additionalProperties":false,"properties":{"city":{"type":["string","null"]},"country":{"type":["string","null"]},"line1":{"type":["string","null"]},"line2":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"state":{"type":["string","null"]}},"required":["line1","line2","city","state","postal_code","country"],"type":"object"},"email":{"type":["string","null"]},"name":{"type":["string","null"]},"phone":{"type":["string","null"]}},"required":["name","email","phone","address"],"type":"object"},{"type":"null"}],"description":"Buyer-supplied shipping contact from Stripe Checkout: name, email, phone and the postal address (Stripe field names, e.g. `postal_code`), which the seller needs to buy a shipping label. Contains personal data: handle accordingly and do not log it. Null on the DIRECT (pickup) rail and on non-shipping orders."},"connectedAccountId":{"type":["string","null"]},"createdAt":{"$ref":"#/components/schemas/IsoDateTime"},"disputeState":{"enum":["none","open","resolved","chargeback_open","chargeback_resolved"],"type":"string"},"fulfillmentMode":{"enum":["PICKUP","SHIPPING"],"type":"string"},"id":{"type":"string"},"listingId":{"type":"string"},"listingSnapshot":{"$ref":"#/components/schemas/Listing","description":"Immutable copy of the listing as it was when the order was placed."},"paymentId":{"type":["string","null"]},"pickupSessionId":{"type":["string","null"]},"priceSnapshot":{"$ref":"#/components/schemas/MoneyBreakdown","description":"Immutable price breakdown, integer minor units."},"protectionTier":{"enum":["DIRECT_BASIC","CHECKOUT_PICKUP","CHECKOUT_SHIPPING","VERIFIED_HIGH_RISK"],"type":"string"},"quantity":{"exclusiveMinimum":0,"maximum":9007199254740991,"type":"integer"},"rail":{"enum":["DIRECT","CHECKOUT"],"type":"string"},"reviewEligibilityState":{"enum":["not_eligible","completed_transaction_review","seller_cancel_feedback","structured_no_show_feedback","resolution_only"],"type":"string"},"sellerAccountId":{"type":"string"},"shipmentId":{"type":["string","null"]},"status":{"enum":["created","checkout_pending","payment_captured","seller_accepted","scheduled","inspecting","packing","shipped","delivered","inspection_window","completed","abandoned","cancelled","refunded","buyer_no_show","seller_no_show","rejected_at_pickup","dispute_open"],"type":"string"},"stripeCheckoutSessionId":{"type":["string","null"]},"updatedAt":{"$ref":"#/components/schemas/IsoDateTime"}},"required":["id","listingId","buyerId","sellerAccountId","connectedAccountId","quantity","rail","fulfillmentMode","protectionTier","status","listingSnapshot","priceSnapshot","stripeCheckoutSessionId","checkoutShippingDetails","paymentId","pickupSessionId","shipmentId","reviewEligibilityState","disputeState","createdAt","updatedAt"],"type":"object"},"OrderResponse":{"additionalProperties":false,"properties":{"order":{"$ref":"#/components/schemas/Order"}},"required":["order"],"type":"object"},"PackageDimensionsMm":{"additionalProperties":false,"properties":{"heightMm":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"lengthMm":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"widthMm":{"maximum":9007199254740991,"minimum":0,"type":"integer"}},"required":["lengthMm","widthMm","heightMm"],"type":"object"},"Plan":{"additionalProperties":false,"properties":{"entitlements":{"description":"Features the effective tier unlocks. Programmatic writes require \"api_write\".","items":{"enum":["api_write","cross_post_oneway","cross_post_bidirectional","ai_unlimited","custom_storefront","editorial_spot"],"type":"string"},"type":"array"},"limits":{"$ref":"#/components/schemas/PlanLimits"},"tier":{"description":"Effective tier. A seller with no subscription — or one that lapsed — resolves to \"free\".","enum":["free","pro","business"],"type":"string"}},"required":["tier","entitlements","limits"],"type":"object"},"PlanLimits":{"additionalProperties":false,"properties":{"aiCopilotRunsPerMonth":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}],"description":"AI copilot runs per month; null means unlimited."},"apiRequestsPerMonth":{"description":"ADVISORY, not currently enforced: the published monthly request allowance for the tier (0 on free, and finite on every tier). No monthly counter is metered against it today. The limit that IS enforced is a per-key burst budget of 1000 requests, whose window clears only after 60 consecutive seconds of idle time; exceeding it answers 429.","maximum":9007199254740991,"minimum":0,"type":"integer"},"maxActiveListings":{"anyOf":[{"maximum":9007199254740991,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Max simultaneously-active listings; null means unlimited. Enforced at the publish transition, not at creation."}},"required":["maxActiveListings","aiCopilotRunsPerMonth","apiRequestsPerMonth"],"type":"object"},"SearchResponse":{"additionalProperties":false,"properties":{"hasMore":{"type":"boolean"},"limit":{"maximum":100,"minimum":1,"type":"integer"},"offset":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"query":{"type":"string"},"results":{"description":"Ranked results, best first, drawn from the 200 most recently listed active listings.","items":{"$ref":"#/components/schemas/ListingSummary"},"type":"array"}},"required":["query","results","limit","offset","hasMore"],"type":"object"},"UpdateListingRequest":{"additionalProperties":false,"properties":{"checkoutEnabled":{"type":"boolean"},"description":{"type":"string"},"directEnabled":{"type":"boolean"},"imageUrls":{"description":"Absolute http(s) image URLs in display order, at most 10; the first is the cover. Replaces the whole list. Only URLs under Marka's media storage are linked to the listing's photo assets (the cover image on market and seller pages); any other host is stored but not shown.","items":{"pattern":"^https?:\\/\\/[^\\s/?#]\\S*$","type":"string"},"maxItems":10,"type":"array"},"madeInCountry":{"anyOf":[{"maxLength":2,"minLength":2,"type":"string"},{"type":"null"}],"description":"Country of manufacture as an ISO 3166-1 alpha-2 code (e.g. CA, DE), stored uppercase; null when not specified. Used as the item's origin country on international shipping labels (customs and duties). A lowercase code is accepted and uppercased; an unknown code is rejected. On an update, null clears it and omitting the field leaves it unchanged."},"pickupEnabled":{"type":"boolean"},"price":{"description":"Integer minor units of the listing's currency.","maximum":9007199254740991,"minimum":0,"type":"integer"},"shippingEnabled":{"type":"boolean"},"title":{"maxLength":200,"minLength":1,"type":"string"}},"type":"object"},"User":{"additionalProperties":false,"properties":{"email":{"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["id","email","name"],"type":"object"}},"securitySchemes":{"apiKey":{"description":"API key created in your Marka account settings, sent as an `x-api-key` header (an `Authorization: Bearer mk_…` header is accepted as an equivalent spelling). Key-authenticated writes additionally require the `api_write` entitlement, which the Pro plan and above carry. A signed-in browser session cookie is also accepted for interactive exploration from the Marka web app; SDK and server-to-server clients always use a key.","in":"header","name":"x-api-key","type":"apiKey"}}},"info":{"description":"The Marka seller API. Authenticate with an API key created in your Marka account settings and sent as an `x-api-key` header. All monetary amounts are integer minor units of the accompanying currency (e.g. cents for USD).","title":"Marka API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/v1/categories":{"get":{"operationId":"listCategories","parameters":[{"description":"How many categories to return, 1-50. Defaults to 50, which returns the whole set unless more than 50 categories carry active listings — there is no second page, so a lower limit only truncates the tail, it never surfaces different categories.","in":"query","name":"limit","required":false,"schema":{"description":"How many categories to return, 1-50. Defaults to 50, which returns the whole set unless more than 50 categories carry active listings — there is no second page, so a lower limit only truncates the tail, it never surfaces different categories.","maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCategoriesResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed — the request body or query did not match the schema."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"List active listing categories","tags":["Search"]}},"/v1/listings":{"get":{"operationId":"listListings","parameters":[{"description":"Page size, 1-100. Defaults to 50.","in":"query","name":"limit","required":false,"schema":{"description":"Page size, 1-100. Defaults to 50.","maximum":100,"minimum":1,"type":"integer"}},{"description":"Number of records to skip. Defaults to 0.","in":"query","name":"offset","required":false,"schema":{"description":"Number of records to skip. Defaults to 0.","maximum":9007199254740991,"minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListListingsResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed — the request body or query did not match the schema."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"List your listings","tags":["Listings"]},"post":{"operationId":"createListing","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateListingRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingResponse"}}},"description":"Created"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed — the request body or query did not match the schema."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key's plan does not carry the entitlement this endpoint requires."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authenticated, but not permitted to act on this resource."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"Create a draft listing","tags":["Listings"]}},"/v1/listings/{id}":{"get":{"operationId":"getListing","parameters":[{"description":"Listing id.","in":"path","name":"id","required":true,"schema":{"description":"Listing id.","minLength":1,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingResponse"}}},"description":"Success"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No such resource, or it is not visible to this key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"Get a listing by id","tags":["Listings"]},"patch":{"operationId":"updateListing","parameters":[{"description":"Listing id.","in":"path","name":"id","required":true,"schema":{"description":"Listing id.","minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateListingRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed — the request body or query did not match the schema."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key's plan does not carry the entitlement this endpoint requires."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authenticated, but not permitted to act on this resource."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No such resource, or it is not visible to this key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"Update listing fields","tags":["Listings"]}},"/v1/listings/{id}/publish":{"post":{"description":"Publishing requires available stock (quantityTotal - quantityReserved > 0) for both unique and multi-quantity inventory. Otherwise returns HTTP 400 with code out_of_stock and message All units are held by open orders. when quantityTotal > 0, or Active listings require stock. when quantityTotal is 0.","operationId":"publishListing","parameters":[{"description":"Listing id.","in":"path","name":"id","required":true,"schema":{"description":"Listing id.","minLength":1,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed — the request body or query did not match the schema."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key's plan does not carry the entitlement this endpoint requires."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authenticated, but not permitted to act on this resource."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No such resource, or it is not visible to this key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"Publish a draft listing","tags":["Listings"]}},"/v1/me":{"get":{"operationId":"getMe","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}},"description":"Success"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"Get the authenticated account and its plan","tags":["Account"]}},"/v1/orders":{"get":{"operationId":"listOrders","parameters":[{"description":"Page size, 1-100. Defaults to 50.","in":"query","name":"limit","required":false,"schema":{"description":"Page size, 1-100. Defaults to 50.","maximum":100,"minimum":1,"type":"integer"}},{"description":"Number of records to skip. Defaults to 0.","in":"query","name":"offset","required":false,"schema":{"description":"Number of records to skip. Defaults to 0.","maximum":9007199254740991,"minimum":0,"type":"integer"}},{"description":"Restrict to a single order status. Omit for all statuses.","in":"query","name":"status","required":false,"schema":{"description":"Restrict to a single order status. Omit for all statuses.","enum":["created","checkout_pending","payment_captured","seller_accepted","scheduled","inspecting","packing","shipped","delivered","inspection_window","completed","abandoned","cancelled","refunded","buyer_no_show","seller_no_show","rejected_at_pickup","dispute_open"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListOrdersResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed — the request body or query did not match the schema."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"List orders on your listings","tags":["Orders"]}},"/v1/orders/{id}":{"get":{"operationId":"getOrder","parameters":[{"description":"Order id.","in":"path","name":"id","required":true,"schema":{"description":"Order id.","minLength":1,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}},"description":"Success"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No such resource, or it is not visible to this key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"Get an order by id","tags":["Orders"]}},"/v1/search":{"get":{"operationId":"search","parameters":[{"description":"City to anchor the radius filter on; must match a city present in the catalogue. A city that matches none — including one whose listings have all sold — returns no results, rather than silently dropping the location filter and answering with the whole country.","in":"query","name":"city","required":false,"schema":{"description":"City to anchor the radius filter on; must match a city present in the catalogue. A city that matches none — including one whose listings have all sold — returns no results, rather than silently dropping the location filter and answering with the whole country.","type":"string"}},{"description":"Page size, 1-100. Defaults to 50.","in":"query","name":"limit","required":false,"schema":{"description":"Page size, 1-100. Defaults to 50.","maximum":100,"minimum":1,"type":"integer"}},{"description":"Highest acceptable price, in integer minor units.","in":"query","name":"maxPrice","required":false,"schema":{"description":"Highest acceptable price, in integer minor units.","maximum":9007199254740991,"minimum":0,"type":"integer"}},{"description":"Lowest acceptable price, in integer minor units.","in":"query","name":"minPrice","required":false,"schema":{"description":"Lowest acceptable price, in integer minor units.","maximum":9007199254740991,"minimum":0,"type":"integer"}},{"description":"Number of results to skip. Defaults to 0. Search covers the 200 most recently listed active listings, so an offset at or past that ceiling returns an empty page — it does not reach older items.","in":"query","name":"offset","required":false,"schema":{"description":"Number of results to skip. Defaults to 0. Search covers the 200 most recently listed active listings, so an offset at or past that ceiling returns an empty page — it does not reach older items.","maximum":9007199254740991,"minimum":0,"type":"integer"}},{"description":"Only listings offering local pickup.","in":"query","name":"pickup","required":false,"schema":{"description":"Only listings offering local pickup.","type":"boolean"}},{"description":"Free-text query. Omit to browse without a text filter.","in":"query","name":"q","required":false,"schema":{"description":"Free-text query. Omit to browse without a text filter.","type":"string"}},{"description":"Search radius around `city`, in kilometres. Ignored unless `city` is supplied.","in":"query","name":"radiusKm","required":false,"schema":{"description":"Search radius around `city`, in kilometres. Ignored unless `city` is supplied.","exclusiveMinimum":0,"type":"number"}},{"description":"Only listings offering shipping.","in":"query","name":"shipping","required":false,"schema":{"description":"Only listings offering shipping.","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed — the request body or query did not match the schema."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing, malformed, or revoked API key."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded for this API key."}},"security":[{"apiKey":[]}],"summary":"Search the 200 most recently listed active listings","tags":["Search"]}}},"security":[{"apiKey":[]}],"servers":[{"url":"https://joinmarka.com/api"}]}