---
title: "Submit Disbursement"
method: POST
path: "/disbursements/submit"
---

# Submit Disbursement

`POST /disbursements/submit`

## Request

- Base URL: `https://api.durianpay.id/v1`
- URL: `https://api.durianpay.id/v1/disbursements/submit`
- Auth: HTTP basic

The following endpoint submit a disbursement:

## Query parameters

- `force_disburse` boolean

## Headers

- `idempotency_key` string, required
- `X-Idempotency-Key` string, required

## Request body

- object
  - `name` string: The name given for the disbursement batch to be submitted.
  - `description` string: The description for the disbursement batch.
  - `items` object[], required: Detail of transactions to be disbursed in a batch, should contain at least 1 transaction
    - `account_owner_name` string, required: The name of the bank account holder.
    - `bank_code` string, required: The bank code of the account.
    - `amount` string, required: The amount of money to be disbursed.
    - `account_number` string, required: The account number of the recipient.
    - `email_recipient` string: The email of the recipient.
    - `phone_number` string: The phone number of the recipient.
    - `notes` string: The notes for the disbursement if any.
    - `sender_information` object: Part of items object. The details of disbursement sender. This field is optional but it will be mandatory in case of disbursement on behalf of another party.
      - `name` string, required: The name of the sender
      - `country` string, required: The country of the sender. Two letter country code as per ISO-3166 alpha-2 standard
      - `sender_account` object: The account details of sender. The details of sender account. Either of sender_account or sender_identity is required, but both can be included if available.
        - `bank_identifier` string, required: Valid ATM Code or Swift Code for sender bank
        - `account_number` string, required: Account Number of sender
      - `sender_identity` object: The identity details of sender. Either of sender_account or sender_identity is required, but both can be included if available.
        - `identity_type` string, required: Type of sender identity
        - `identity_number` string, required: Identity Number of chosen identity type
      - `job` string: The job of the sender.
      - `date_of_birth` string: The date of birth of the sender in YYYY-MM-DD format
      - `place_of_birth` string: The place of birth of the sender
      - `address` string: The address of the sender

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `name` string
    - `idempotency_key` string
    - `total_amount` string
    - `total_disbursements` integer
    - `description` string
    - `is_split` boolean

## Other responses

- `202`: 202
- `400`: 400
- `401`: 401
- `403`: 403
- `409`: 409
- `500`: 500
- `504`: 504

## Changes

- **2026-11-03** `f8a81a955e0f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/durianpay/apis/durianpay-api/changes/disbursements/submit/post.md)

---

[API](https://skmtc.dev/durianpay/apis/durianpay-api.md) - [All operations](https://skmtc.dev/durianpay/apis/durianpay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/durianpay/apis/durianpay-api/revisions/f8a81a955e0f?raw)