---
title: "Get a bank payment created by the integration"
method: GET
path: "/companies/{companyId}/bank-payments/{bankPaymentId}"
tags: ["bank-payments"]
---

# Get a bank payment created by the integration

`GET /companies/{companyId}/bank-payments/{bankPaymentId}`

Retrieve the information of the bank payment with the matching bankPaymentId.

**Scope:** `bank-payments:read-limited`

## Response `200`

Bank payment found

- 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

- `404` — Bank payment not found

---

[API](https://skmtc.net/bokio/apis/company-api.md) · [All operations](https://skmtc.net/bokio/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bokio/company-api/revisions/1bb5d09ce15e/schema)