---
title: "New bulk payment"
method: POST
path: "bulk-payments"
tags: ["Bulk Payments"]
---

# New bulk payment

`POST bulk-payments`

## Request

- Base URL: `https://payments.air-pay.io`
- URL: `https://payments.air-pay.io/bulk-payments`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/docs/bulk-payments/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new bulk payment. You will receive a response with the id of
your bulk payment and the processing will start asynchronously after you
receive your response. You can check in with the progress of your
ongoing bulk payment with any of the endpoints described further down
this section.

## Headers

- `Content-Type` string
- `Authorization` string

## Request body

- object
  - `0` string[]: Single user information to receive the bulk payment.
  - `1` object
    - `receiver_email` string
    - `amount` number
    - `currency` string
    - `note` string
    - `internal_note` string

## Response `200`

OK

- object
  - `id` string, uuid: Unique identifier automatically generated on bulk payment creation.
  - `status` string: Status of the bulk payment, please check the Possible Statuses section in this endpoint's summary.
  - `payments` object
    - `count` number: Number of individual payments within the bulk payment.

## Other responses

- `500`: Invalid account status

---

[API](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1.md) - [All operations](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/revisions/4e8326a04343?raw)