ForthClear Liquidation Marketplace

Accept a seller's quoted price and charge it with the same payment options as confirm_purchase. Requires buyer purchase access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:purchase). Sensitive: requires user approval each time.

Download your orders as CSV, with order id, product, buyer, quantity, total, status, and date. Requires sign-in with seller access. Only orders you own are included. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:read).

Mark up to 200 of your orders as shipped, with an optional tracking number, tracking link, and carrier applied to the whole batch. Requires sign-in with seller access. Tracking you supply replaces tracking already on those orders, and each buyer is notified. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time.

Change the price or the minimum order quantity on up to 200 of your listings. Requires sign-in with seller access. price_set takes price_cents (integer cents). value_usd is an explicit dollar amount and is deprecated. The percent modes adjust the current price, and moq_set writes a minimum order quantity. Previous values are replaced. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time.

Cancel an unshipped order whose ship-by date has passed, for a full refund. Seller Agreement §5.4. Requires buyer purchase access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:purchase). Sensitive: requires user approval each time.

End the inspection window after it has elapsed. A live order then starts the seller payout. A sandbox order is marked delivered and is not paid out. Requires buyer write access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write).

Charge the previewed checkout with the signed-in buyer's own saved card, off session, or with a Stripe shared payment token when the SDK supports it. Pass confirmation_token from quick_buy or preview_checkout. A token or total that does not match the summary is rejected and nothing is charged. The same idempotency key does not create a second charge. Charges of US$1,000 or more, and cards that need authentication, return requires_action plus a checkout link. Returns confirmed only after the PaymentIntent succeeds and the order exists. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:purchase). Sensitive: requires user approval each time.

Publish a surplus lot for sale. Requires sign-in with seller access. Provide a title, category, condition, quantity, and price per unit. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time.

Read the claim on an order you placed. Requires buyer read access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read).

Check status, tracking, and the inspection deadline for an order you placed. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read).

Suggest a liquidation unit price in cents from MSRP, condition, category, and lot size. No sign-in required. original_retail is MSRP per unit in cents. Larger lots suggest a lower per-unit price. The result is bounded below retail. This does not change any listing's price.

Read one listing: description, price, quantity, condition, photo, and whether instant checkout is available. No sign-in required. Use this before requesting a quote or buying. Pass the exact id from search, for example product_2731.

List quote requests buyers sent you. Requires sign-in with seller access. Filter to pending, responded, or all. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:read).

Check a quote you requested: pending, responded, accepted, rejected, or completed, plus the seller price and shipping once they reply. No sign-in required when you pass the status_token from request_quote. Signed-in buyers can also read their own quotes without the token.

Read whether the signed-in buyer has a card saved for in-chat checkout, and return the page where they can add one. Does not charge the card. Card numbers are not returned. Requires buyer read access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read).

List orders the signed-in buyer placed. Requires buyer read access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read).

List quote requests for the signed-in buyer. Requires buyer read access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read).

List orders for the signed-in seller. Requires seller read access. Returns order id, status, quantity, and total. Buyer contact details stay on the order page. Requires sign-in with seller access. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:read).

Mark a shipped order received. This starts the 3-day inspection window and does not pay the seller. Requires buyer write access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write).

Report a problem with an order. not_received is allowed while the order is marked shipped. Other reasons require a delivered order waiting for confirmation. This records the issue, pauses the seller payout, and notifies ForthClear. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write). Sensitive: requires user approval each time.

Read the seller of record, unit price, shipping, tax, and total for an instant-checkout listing. Does not charge a card. Requires buyer read access. Pass the returned checkout_id to confirm_purchase. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read).

Price an instant checkout for one listing. This does not charge the card. When the signed-in buyer has a saved card and the total is under US$1,000, the result is a summary (items, shipping, total, seller) plus a confirmation_token. Call confirm_purchase with that token and payment.saved_card true to charge the saved card. If there is no saved card, or the card needs authentication (including charges of US$1,000 or more), the result includes the existing checkout link instead. The listing's seller sells the goods. ForthClear runs the marketplace and Stripe processes the payment. buyer_email is required. quantity must be a positive integer below the listing's quote threshold (quote_quantity_threshold from get_product_details). A threshold of 1 means no quantity can be bought instantly. Use request_quote. The listing must have instant checkout and a shipping price. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:purchase). Sensitive: requires user approval each time.

Ask a seller to price a bulk order. No sign-in required if you pass buyer_email, which is where the seller replies. buyer_email is always required, including when you are signed in. Anonymous requests are limited to 5 per hour. Sign in with buyer access to attach the quote to your account. Save status_token and pass it to get_quote_status. This does not charge a card. Sensitive: requires user approval each time.

Answer a quote from a buyer by accepting it, sending a counter-price, or declining. Requires sign-in with seller access. The buyer is notified. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time.

Keyword search of published, in-stock surplus listings. No sign-in required. `query` matches the name, description, brand, SKU, and category words, in any order. If the whole query is a category (electronics, clothes, home goods), it is treated as that category filter. Pass `category` as a catalogue category, such as electronics or home_goods, when you want to limit results. `max_price` is the maximum unit price in cents. `condition` is salvage, customer_returns, shelf_pulls, overstock, or new_or_refurbished. Name, brand, and SKU matches rank above description matches. For a sentence about what you want, use search_inventory_semantic.

Find listings by describing what you want in everyday language, such as returned kitchen appliances in bulk. No sign-in required. Semantic matches include similarity from 0 to 1 and match_type semantic. When the embedding index is empty or no provider is configured, results use keyword search, similarity is null, and match_type is keyword_fallback. category, when set, is one catalogue category such as electronics. max_price is the maximum unit price in cents.

Search the supplier directory. No sign-in required. Returns published company profiles only, including profiles a company has claimed. These are not lots for sale. A profile is compiled from public sources and is not an endorsement. Use search_inventory to find lots you can buy. Filter with query, country, type (3pl, returns_processor, brand_retailer, liquidator, other), or category.

Summarise your seller inbox: quotes waiting for a reply, orders that may miss their ship-by date, and orders with reported problems. Requires sign-in with seller access. Use it to decide what to answer or ship next. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:read).

Set how your listings ship: the shipping price per unit, or that shipping is quoted per order, and the lot type (parcel, pallet, truckload or mixed). Optionally set where your stock ships from; that is part of your seller account and shows on all your listings. Requires sign-in with seller access. Up to 200 of your listings per call; every id must be yours or nothing changes. shipping_price_cents is charged per unit at checkout (0 means free shipping). quote_shipping=true removes the fixed price so buyers ask for a quote, and turns off instant checkout on those listings, because instant checkout needs a fixed shipping price. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time.

Save a catalogue search and receive new matching listings by email, webhook, or a pollable feed. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write).