API reference

GraphQL queries and mutations for Collectibles.

Endpoint: POST /api/graphql, using the session cookie or an of_ API key.

Public queries

publicCardSets, publicSetChecklist, publicCardMarket, publicBuylist, publicCollectiblesDiscovery, marketplaceCollectiblesCapabilities, getProductsSortedByPrice.

publicCollectiblesDiscovery limits: limit 1 to 24, offset 0 up to the maximum.

Customer operations

activeBinder, addToBinder, removeFromBinder, activeWantList, toggleWantList, activeWishlist, toggleWishlistListing, activeTradeIns, submitTradeIn, plus account, address, order, invoice and privacy operations.

Staff commands

MutationPermission
importCardCatalog(input)canManageCatalog
refreshMarketPrices(input)canManageCatalog
repriceInventory(input)canManageProducts
receiveCollectibleItem(input)Listing and inventory permissions
manageCollectibleListing(input)Listing permissions

Commands that take an idempotency key require 8 to 200 characters.

Shared commerce

Cart and checkout (createActiveCart, updateActiveCart, updateActiveCartLineItem, addActiveCartShippingMethod, initiatePaymentSession, completeActiveCart), transitionOrderStatus, confirmManualPayment, fulfillment, shipping labels and rates, processReturnRefund, invoices, adjustInventory, importInventory, registerWebhookEndpoint, retryWebhookDeliveries.

Not yet released

placeCollectibleBid and submitCollectibleOffer return an error until the auction and offer lifecycles are released (AUCTION_LIFECYCLE_RELEASED, OFFER_LIFECYCLE_RELEASED).

On this page