---
title: "Bulk create bank payments"
method: POST
path: "/companies/{companyId}/bank-payments/bulk"
tags: ["bank-payments"]
---

# Bulk create bank payments

`POST /companies/{companyId}/bank-payments/bulk`

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/companies/{companyId}/bank-payments/bulk`
- Auth: HTTP bearer

Creates multiple bank payments for the company in a single request. Up to 100 payments can be created per request.

The operation is atomic — if any payment fails validation, no payments are created.

**Scope:** `bank-payments:write`

## Request body

- BulkCreateBankPaymentsRequest
  - `payments` BankPayment[], required: List of bank payments to create (1-100 items)
    - `id` string, uuid: Unique identifier of the payment
    - `status` 'readyToSign' | 'onTheWay' | 'scheduled' | 'paid' | 'rejected' | 'cancelled' | 'error': Current status of the payment
    - `createdDateTime` string, date-time: Date and time when the payment was created
    - `amount` number, double, required: Amount of the payment
    - `paymentDate` string, date, required: Date of the payment
    - `ownNote` string: Own note for the payment
    - `recipientRef` union, required: Payment recipient information
      - BankgiroRecipient
        - `kind` 'bankgiro', required
        - `recipientName` string, required: Name of the payment recipient
        - `bankgiroNumber` string, required: Bankgiro number (required for Bankgiro payments)
        - `ocr` string: OCR reference for the payment. Either `ocr` or `message` must be provided, but not both.
        - `message` string: Message for the payment. Either `message` or `ocr` must be provided, but not both.
      - TransferRecipient
        - `kind` 'transfer', required
        - `recipientName` string, required: Name of the payment recipient
        - `recipientReference` string: Reference for the payment recipient
        - `clearingNumber` string, required: Clearing number (required for Transfer payments)
        - `accountNumber` string, required: Account number (required for Transfer payments)

## Response `200`

All payments created successfully.

- BankPayment[]
  - `id` string, uuid: Unique identifier of the payment
  - `status` 'readyToSign' | 'onTheWay' | 'scheduled' | 'paid' | 'rejected' | 'cancelled' | 'error': Current status of the payment
  - `createdDateTime` string, date-time: Date and time when the payment was created
  - `amount` number, double, required: Amount of the payment
  - `paymentDate` string, date, required: Date of the payment
  - `ownNote` string: Own note for the payment
  - `recipientRef` union, required: Payment recipient information
    - BankgiroRecipient
      - `kind` 'bankgiro', required
      - `recipientName` string, required: Name of the payment recipient
      - `bankgiroNumber` string, required: Bankgiro number (required for Bankgiro payments)
      - `ocr` string: OCR reference for the payment. Either `ocr` or `message` must be provided, but not both.
      - `message` string: Message for the payment. Either `message` or `ocr` must be provided, but not both.
    - TransferRecipient
      - `kind` 'transfer', required
      - `recipientName` string, required: Name of the payment recipient
      - `recipientReference` string: Reference for the payment recipient
      - `clearingNumber` string, required: Clearing number (required for Transfer payments)
      - `accountNumber` string, required: Account number (required for Transfer payments)

## Other responses

- `400`: Validation failed. No payments were created. Errors include the payment index in the field path.

---

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