API updates for payouts, shipping, and connected apps
We’ve added payout information, shipment history fields, and more OAuth permissions to the Mana Pool API.

Illustration of the API additions.
Read payouts and balances
Sellers can now use their own API key to read payouts, the orders and deductions included in them, and their current balance:
| Endpoint | What it provides |
|---|---|
GET /api/v1/seller/payouts |
A paginated payout list |
GET /api/v1/seller/payouts/{id} |
One payout’s details |
GET /api/v1/seller/payouts/{id}/orders |
Orders included in the payout |
GET /api/v1/seller/payouts/{id}/deductions |
Associated deductions |
GET /api/v1/seller/balance |
Current balance buckets |
Amounts are reported in USD cents. These five endpoints share a limit of 10 requests per minute per seller and require the seller’s own API key; they are not available to third-party OAuth apps. A completed transfer should not be treated as confirmation that money has arrived in a bank account.
See when an order was marked shipped
Fulfillment responses now include marked_shipped_at and marked_shipped_by. These tell you when the seller first marked the shipment shipped, and whether that came from the website, a CSV import, or an integration.
The timestamp is when the seller marked it shipped, rather than a carrier scan. If the tracking is corrected later, the original timestamp stays the same. These fields may be null when we don’t have that information.
More permissions for connected apps
OAuth apps can now request these additional permissions, with the account holder’s consent:
settings:seller:writeto update seller vacation and shipping settings throughPUT /api/v1/account.buyer_orders:readto read the account’s buyer orders.decks:readto read Commander decks for sale through the deckbuilder endpoint.
Existing integrations don’t automatically get these permissions. Contact support if you need to add them to an existing registration. Accounts don’t have to be sellers to grant access to their buyer orders or decks.
See the API documentation for request parameters and response formats.