> For the complete documentation index, see [llms.txt](https://docs.omypayments.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omypayments.com/api/api-endpoints/mass-payouts.md).

# Mass Payouts

Programmatically create payout lists, add recipients, and launch a distribution run. This page documents the HTTP endpoints you’ll call from your backend. Authentication and error-envelope format follow the public API style. 

> **Base URL**: `https://api.omypayments.com`\
> **Version**: `v2` (all endpoints below start with `/2.0/...`)\
> **Auth**: add your API key in the header: `apiKey: <yourApiKey>`&#x20;

**Prerequisites**

* Make sure the tokens you intend to use are enabled/configured in **Assets** (dashboard).
* When preparing `amount` values for token payouts, use the token’s base units (see `crypto.decimals` on the “Get Merchant Asset Data” endpoint to convert, if needed).