# Auction Now API

## Docs

- [Create a new auction](https://docs.auctionnow.io/api-reference/auctions/create-a-new-auction.md)
- [Delete an auction](https://docs.auctionnow.io/api-reference/auctions/delete-an-auction.md): Soft-delete an auction by its slug. The associated product is set to DRAFT status.
- [Get auctions](https://docs.auctionnow.io/api-reference/auctions/get-auctions.md): Get auctions belonging to the authenticated merchant
- [Get merchant auction by slug](https://docs.auctionnow.io/api-reference/auctions/get-merchant-auction-by-slug.md): Get a single auction by its slug
- [Get public auction by slug](https://docs.auctionnow.io/api-reference/auctions/get-public-auction-by-slug.md): Get a public auction's full details by its unique slug
- [Get watch count for an auction](https://docs.auctionnow.io/api-reference/auctions/get-watch-count-for-an-auction.md): Get the total number of watchers for an auction's product
- [List bids on an auction](https://docs.auctionnow.io/api-reference/auctions/list-bids-on-an-auction.md): Get all bids for a specific auction by slug
- [List customers who interacted with an auction](https://docs.auctionnow.io/api-reference/auctions/list-customers-who-interacted-with-an-auction.md): Get all customers (bidders and watchers) for a specific auction by slug
- [List merchant's active auctions](https://docs.auctionnow.io/api-reference/auctions/list-merchants-active-auctions.md): Get all active auctions for a merchant by their handle. Only returns auctions that have not ended.
- [List orders by auction slug](https://docs.auctionnow.io/api-reference/auctions/list-orders-by-auction-slug.md): List all orders for a specific auction, identified by its slug
- [List proxy bids on an auction](https://docs.auctionnow.io/api-reference/auctions/list-proxy-bids-on-an-auction.md): Get all proxy (max) bids for a specific auction by slug
- [List public bids on an auction](https://docs.auctionnow.io/api-reference/auctions/list-public-bids-on-an-auction.md): Get the public bid history for an auction. Returns bidder names but not emails.
- [List watches on an auction](https://docs.auctionnow.io/api-reference/auctions/list-watches-on-an-auction.md): Get all watches for a specific auction's product by auction slug
- [Update an auction](https://docs.auctionnow.io/api-reference/auctions/update-an-auction.md): Update an auction by its slug
- [Get merchant balance](https://docs.auctionnow.io/api-reference/balance/get-merchant-balance.md): Get the balance for the authenticated merchant
- [Create an order for a customer](https://docs.auctionnow.io/api-reference/customer-actions/create-an-order-for-a-customer.md): Create a buy-it-now order on behalf of a customer. Works for both auction products and standalone products.
- [Create or update a max bid for a customer](https://docs.auctionnow.io/api-reference/customer-actions/create-or-update-a-max-bid-for-a-customer.md): Set a maximum bid (proxy bid) on an auction on behalf of a customer. If a max bid already exists, it will be updated.
- [List orders for a customer](https://docs.auctionnow.io/api-reference/customer-actions/list-orders-for-a-customer.md): List all orders associated with a specific customer
- [Place a bid for a customer](https://docs.auctionnow.io/api-reference/customer-actions/place-a-bid-for-a-customer.md): Place a bid on an auction on behalf of a customer. Amounts are in USD.
- [Remove a watch for a customer](https://docs.auctionnow.io/api-reference/customer-actions/remove-a-watch-for-a-customer.md): Remove a watch on a product for a customer. The `id` path parameter is the productId.
- [Update a max bid for a customer](https://docs.auctionnow.io/api-reference/customer-actions/update-a-max-bid-for-a-customer.md): Update the maximum bid amount for an existing max bid. The `id` path parameter is the auctionId.
- [Watch an product for a customer](https://docs.auctionnow.io/api-reference/customer-actions/watch-an-product-for-a-customer.md): Add a watch on an product on behalf of a customer. Returns existing watch if already watching.
- [Create payment setup session](https://docs.auctionnow.io/api-reference/customer-payments/create-payment-setup-session.md): Create a Stripe Checkout Session in setup mode for collecting a customer's payment method
- [Get customer payment status](https://docs.auctionnow.io/api-reference/customer-payments/get-customer-payment-status.md): Check whether a customer has a valid payment method set up in Stripe
- [Get customer by ID](https://docs.auctionnow.io/api-reference/customers/get-customer-by-id.md): Get a single customer by their ID
- [List customers](https://docs.auctionnow.io/api-reference/customers/list-customers.md): List all customers for the authenticated merchant
- [Register or get customer](https://docs.auctionnow.io/api-reference/customers/register-or-get-customer.md): Register a new customer or return the existing one if a customer with the same email already exists for this merchant
- [Update customer](https://docs.auctionnow.io/api-reference/customers/update-customer.md): Update a customer's name or email
- [Upload an image](https://docs.auctionnow.io/api-reference/images/upload-an-image.md): Upload an image file. Supported formats: JPEG, PNG, GIF, WebP, HEIC. Max size: 10 MB.
- [Get merchant public profile](https://docs.auctionnow.io/api-reference/merchants/get-merchant-public-profile.md): Get a merchant's public profile and theme/branding data by handle
- [Get order by ID](https://docs.auctionnow.io/api-reference/orders/get-order-by-id.md): Get a single order by its ID
- [Get tracking info](https://docs.auctionnow.io/api-reference/orders/get-tracking-info.md): Look up tracking information for a shipment and send a shipping notification email to the buyer
- [List orders](https://docs.auctionnow.io/api-reference/orders/list-orders.md): List all orders for the authenticated merchant
- [Update tracking number](https://docs.auctionnow.io/api-reference/orders/update-tracking-number.md): Update the tracking number for an order
- [List payouts](https://docs.auctionnow.io/api-reference/payouts/list-payouts.md): List all payouts for the authenticated merchant
- [Request a payout](https://docs.auctionnow.io/api-reference/payouts/request-a-payout.md): Request a payout from your available balance. The amount will be deducted from your available balance.
- [Create a new product](https://docs.auctionnow.io/api-reference/products/create-a-new-product.md)
- [Delete a product](https://docs.auctionnow.io/api-reference/products/delete-a-product.md): Archive a product by its slug. Archived products are hidden but preserved for history.
- [Get merchant product by slug](https://docs.auctionnow.io/api-reference/products/get-merchant-product-by-slug.md): Get a single product by its slug
- [Get public product by slug](https://docs.auctionnow.io/api-reference/products/get-public-product-by-slug.md): Get a public product's full details by its unique slug
- [List merchant's active products](https://docs.auctionnow.io/api-reference/products/list-merchants-active-products.md): Get all active products for a merchant by their handle. Only returns in-stock products with available quantity.
- [List products](https://docs.auctionnow.io/api-reference/products/list-products.md): List products belonging to the authenticated merchant
- [List watches on a product](https://docs.auctionnow.io/api-reference/products/list-watches-on-a-product.md): Get all watches for a specific product by slug
- [Update a product](https://docs.auctionnow.io/api-reference/products/update-a-product.md): Update a product by its slug
- [E-Commerce Demo](https://docs.auctionnow.io/ecommerce-demo.md): Explore a sample e-commerce app powered by the Auction Now API
- [Getting Started](https://docs.auctionnow.io/getting-started.md): Create your account and API key to get started using the Auction Now API
- [Auction Now API Docs](https://docs.auctionnow.io/index.md): Add real-time auctions to any application

## OpenAPI Specs

- [doc](https://api.auctionnow.io/api/alpha/doc)