We’ve added payout information, shipment history fields, and more OAuth permissions to the Mana Pool API.

API overview: seller keys access payout records; fulfillment responses include shipment timestamps and source; OAuth apps request specific permissions.

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:write to update seller vacation and shipping settings through PUT /api/v1/account.
  • buyer_orders:read to read the account’s buyer orders.
  • decks:read to 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.