list_shops (Read) — Lists every shop you can access. You can search by shop name or domain and limit the number of results.

get_shop_settings (Read) — Shows about 100 shop configuration options across billing, widgets, shipping, returns, claims, and more. Needs shop_id.

update_shop_settings (Write) — Changes only the shop settings you provide and leaves other settings unchanged. Needs shop_id and a settings object.

list_orders (Read) — Lists and searches orders by order details, customer details, or tracking numbers. You can filter by date, insurance status (insured or uninsured), refund status (refunded or not_refunded), return status (returned, return_in_progress, or not_returned), editing status (edited or not_edited), protection source (customer, merchant, or merchant_auto), and order type (checkout or recurring).

get_order (Read) — Shows an order’s financial and fulfillment status, line items, protection, customer, addresses, shipments, claims, returns, and refunds. Needs id.

protect_order (Write · requires Checkout+) — Adds merchant-funded Checkout+ protection to an eligible order that was not protected at checkout. Needs id.

list_customers (Read) — Lists and searches customers by name, email, or your shop’s customer ID. You can narrow results by shop and use cursor pagination.

get_customer (Read) — Shows a customer’s contact information, fraud and redaction status, default address, orders, CashBack balance, claims, returns, and customer score. Needs id.

list_claims (Read) — Lists and searches package protection claims by claim key, order, or customer. You can filter by claim status (in_progress, unqualified, on_hold, pending_merchant_action, resolved, or denied), status reason, cause (stuck_in_transit, damaged, stolen, missing, wrong_item, not_satisfied, returned, chargeback, or late_delivery), and creation date.

get_claim (Read) — Shows a package protection claim’s cause, status, amounts, line items, order, customer, and conversation. Needs id.

list_rewards (Read) — Lists and searches CashBack rewards by discount code or customer. You can filter by usage status, sort results, and paginate through them.

list_subscriptions (Read) — Lists and searches subscriptions by subscription platform ID or customer email. You can filter by subscription status and paginate through results.

toggle_recharge_subscription_insurance (Write) — Enables or disables Checkout+ protection on the next queued charge for a Recharge subscription. Needs id and insurance_enabled.

list_return_requests (Read) — Lists and searches return requests by return number, order, or customer. You can filter by processing stage (manual_review, open, or closed), shipping label state (not_dropped, in_transit, delivered, available_for_pickup, return_to_sender, error, cancelled, voided, expired, or manual), return type (refund, store_credit, or exchange), and exchange fulfillment status (fulfilled, partial, or restocked).

get_return_request (Read) — Shows a return request’s status, resolution, items, exchange items, shipping, tracking, settlement, amounts, and merchant notes. Needs id.

get_return_request_tracking (Read) — Shows return shipping labels, tracking details, return-window deadlines, and tracking events. Needs id.

set_return_request_status (Write) — Advances a return request to open, declined, closed, or completed. The result can approve a return, refund or void it, process its resolution, or generate a shipping label. Needs id and status; shipment_provider can be ship_sidekick or manual when approving.

remove_return_request_item (Write) — Permanently removes an item and any exchange item tied to it from an open or requested return. Needs id.

set_return_request_item_restock (Write) — Sets whether a return item should be restocked after processing. Needs id and restock.

update_exchange_item (Write) — Changes the quantity of a requested exchange item. Setting quantity to 0 removes it. Needs id and quantity.

get_order_editing_settings (Read) — Shows which changes customers can make to placed orders and the change deadline. Needs shop_id.

update_order_editing_settings (Write) — Changes only the Order Editing settings you provide and leaves other settings unchanged. Needs shop_id and a settings object.

get_order_edit_history (Read) — Shows the latest-first history of item, address, quantity, discount, commit, finalize, and cancel events for an order. Needs id.

get_track_settings (Read) — Shows Track notification toggles, enrichment options, and the per-package tracking fee. Needs shop_id.

update_track_settings (Write) — Changes only the Track settings you provide and leaves other settings unchanged. Needs shop_id and a settings object.

get_order_tracking (Read) — Shows package carriers, tracking numbers and URLs, delivery status, estimated and actual delivery, tracking events, and package line items. Needs id.

get_appearance_settings (Read) — Shows consumer-facing colors, tagline, translations, and Checkout+ widget configuration such as copy, selectors, and powered-by branding. Needs shop_id.

update_appearance_settings (Write) — Changes only the Appearance settings you provide. Values such as translations and subheading_overrides must be JSON-encoded strings. Needs shop_id and a settings object.

protect_order adds merchant-funded Checkout+ protection to an eligible order.

remove_return_request_item permanently removes a return item and any exchange item tied to it.

set_return_request_item_restock changes whether a return item should be restocked after processing.

toggle_recharge_subscription_insurance enables or disables protection on a Recharge subscription’s next queued charge.

update_appearance_settings changes Appearance settings and records the change in the settings audit history.

update_exchange_item changes an exchange quantity and can remove the exchange item when the quantity is 0.

update_order_editing_settings changes Order Editing settings and records the change in the settings audit history.

set_return_request_status can refund, void, process, or generate a shipping label for a return request.

update_shop_settings changes the shop settings you provide and records the change in the settings audit history.

update_track_settings changes Track settings and records the change in the settings audit history.