> 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/list-tasks.md).

# List tasks

`GET /2.0/mass-payout/tasks`

Your payout tasks, newest first.

**Permission:** `can_payout`.

| Query parameter | Type     | Meaning                                                |
| --------------- | -------- | ------------------------------------------------------ |
| `cursor`        | `string` | Page cursor from a previous response                   |
| `status`        | `string` | `pending` \| `failed` \| `success`                     |
| `assetId`       | UUID     | Filter by asset                                        |
| `payoutId`      | UUID     | Filter by the parent payout                            |
| `createdAtFrom` | `string` | ISO-8601 with offset, e.g. `2026-07-01T00:00:00+00:00` |
| `createdAtTo`   | `string` | Same format                                            |

Page size is fixed at **50**.

#### Response `200`

```json
{
  "data": [
    {
      "id": "{uuid}",
      "type": "multi_tx",
      "status": "success",
      "subStatus": "payout_sent",
      "payoutId": "{payoutId}",
      "amount": "100000000000000000000",
      "amountInUsd": "100.00",
      "assetId": "5c3767ab-220c-4fce-b3af-20ffcf2d2729",
      "crypto": {
        "id": "{cryptoId}",
        "title": "Binance Pegged USDT",
        "symbol": "USDT",
        "contractAddress": "0x0000000000000000000000000000000000000000",
        "decimals": 18,
        "logoURI": "https://raw.githubusercontent.com/0xsquid/assets/main/images/tokens/usdt.svg"
      },
      "network": {
        "id": "{networkId}",
        "title": "BNB Chain",
        "symbol": "BSC",
        "chainId": "56",
        "networkType": "evm"
      },
      "transferTxHash": "{transferTxHash}",
      "payoutTxHash": "{payoutTxHash}",
      "targetsCount": 4,
      "fee": {
        "network": [
          {
            "amount": "2650000000000000",
            "amountFormatted": "0.00265",
            "currency": "BNB",
            "cryptoId": "75608cde-155c-4550-8025-cddf01bf2289",
            "networkId": "e130ce89-1d4d-4951-beaf-465ec43cf399",
            "amountInUsd": null,
            "isChargedToMerchant": false
          }
        ],
        "service": {
          "amount": "1000000000000000000",
          "amountFormatted": "1",
          "currency": "USDT",
          "cryptoId": "1fa107f9-3832-4286-9c72-493eaf675da5",
          "networkId": "e130ce89-1d4d-4951-beaf-465ec43cf399",
          "amountInUsd": "1.00",
          "isChargedToMerchant": true
        },
        "exchange": null,
        "totalInUsd": "1.00"
      },
      "createdAt": "2026-07-28T10:53:41+00:00"
    }
  ],
  "cursorPrevious": null,
  "cursorNext": "c3c5VkZFbFppODFqYmllZDczTkgzTHE2d1hZOXZlVC9ma1NaMTNPejI2dz0="
}
```

Pass `cursorNext` back as `?cursor=…` for the next page. A `null` cursor means there is no page in that direction.

🔴 The merchant scope comes from your apiKey. A `merchantId` query parameter has no effect.