---
search:
  tags:
    - Payouts
    - POST
seo:
  description: >-
    Sends up to 100 payouts in one request. Each item has the same fields as
    POST… Reference for the POST /v1/payout-batches endpoint in the iSmartPay
    API.
sidebar:
  label: Send up to 100 payouts at once
  badge: POST
title: Send up to 100 payouts at once
type: openapi-operation
---
Sends up to 100 payouts in one request. Each item has the same fields as `POST /v1/payouts` and is accepted or refused on its own, so one refusal does not stop the others. Your limits apply to each item as if it were sent alone.

If the batch itself is malformed (no items, more than 100, an invalid item or a `reference` repeated within the batch), the whole batch is refused with `400` and nothing is sent.

A `200` lists each item with its `status`: `202` and the `payout` when it was accepted, otherwise an `error` with the same codes a single payout would get, such as `daily_limit_exceeded`. Read each payout back with `GET /v1/payouts/{reference}`; webhooks arrive for each payout, not for the batch.

Send a required `Idempotency-Key` header. After a timeout or a `5xx`, retry with the same key and body: accepted items are not sent again. Requires the `disbursements.write` permission.

`POST /v1/payout-batches`