Documentation
Build on Basta
The official documentation for integrating with the Basta auction platform. Configure sales, surface them to bidders, and react to everything in real time.
New to Basta?
Set up your account and make your first API call.
ReadBuilding an integration?
Walk through creating your first auction end to end.
ReadReceiving webhooks?
See every event type and payload structure.
ReadNeed real-time updates?
Stream auction activity over WebSocket subscriptions.
ReadDashboard
APIs
- Management APIBack-office API for configuring, launching, and operating auctions.
- Client APIPublic-facing API for browsing auctions and placing bids.
- SubscriptionsReal-time auction updates over WebSockets.
- SearchFull-text search across items, sales, and users.
- SDKsType-safe TypeScript React SDK — a single abstraction over the GraphQL APIs.
Selling
- Sale TypesOnline timed auctions and live, auctioneer-driven sales.
- Dutch Auctions (Beta)Descending-price auctions: schedules, clock price, and uniform clearing.
- RegistrationsRegister, vet, and approve bidders before a sale.
- Orders, Payments & FeesThe order lifecycle, configurable fees, invoices, and payments.
Integrations
- WebhooksType definitions and payloads for every webhook event.
- Managing WebhooksSubscribe to, test, and retry webhook deliveries.
- NotificationsBidder email & SMS notification preferences, provider setup, and live in-sale alerts.
- ShopifyRun auctions on your existing Shopify store.
- Identity ProvidersBack your bidders with an external identity provider.
- MarketplaceA fixed-price commerce layer alongside your auctions.