---
title: "Get reference payment status"
method: GET
path: "/v1/referencePayments/status/{paymentId}"
tags: ["Bank Account Verification"]
---

# Get reference payment status

`GET /v1/referencePayments/status/{paymentId}`

Use this endpoint to check the [status](https://docs.fourthline.com/docs/bav-statuses) and transfer information of a Bank Account Verification reference payment. <br /><br /><img src="https://files.readme.io/310d4d3-Inline_Caution.svg" align="left" alt="Important" /> **Important:** Before using this endpoint, see the <a href="https://docs.fourthline.com/docs/bav-integration">integration guide</a>.

## Path parameters

- `paymentId` string, required

## Headers

- `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response.

## Response `200`

The reference payment status was retrieved successfully

- union
  - object
    - `status` string — The [Bank Account Verification status](https://docs.fourthline.com/docs/bav-statuses).
  - object
    - `status` string — The [Bank Account Verification status](https://docs.fourthline.com/docs/bav-statuses).
    - `transferData` object, nullable — Information from the requested transfer. May be null.
      - `iban` string, nullable — The IBAN received in the transfer. May be null.
      - `name` string, nullable — The accountholder name received in the transfer. May be null.
      - `transferReference` string, nullable — The unique reference of the transfer. May be null.
      - `currency` string, nullable — The currency of the transfer. May be null.
      - `amountRequested` string, nullable — The amount of the transfer. May be null.
  - object
    - `status` string — The [Bank Account Verification status](https://docs.fourthline.com/docs/bav-statuses).
    - `transferData` object, nullable — Information from the requested transfer. May be null.
      - `iban` string, nullable — The IBAN received in the transfer. May be null.
      - `name` string, nullable — The accountholder name received in the transfer. May be null.
      - `transferReference` string, nullable — The unique reference of the transfer. May be null.
      - `currency` string, nullable — The currency of the transfer. May be null.
      - `amountRequested` string, nullable — The amount of the transfer. May be null.
  - object
    - `status` string — The [Bank Account Verification status](https://docs.fourthline.com/docs/bav-statuses).
    - `message` string — The Bank Account Verification [status code](https://docs.fourthline.com/docs/bav-statuses#status-codes).
    - `transferData` object, nullable — Information from the requested transfer. May be null.
      - `iban` string, nullable — The IBAN received in the transfer. May be null.
      - `name` string, nullable — The accountholder name received in the transfer. May be null.
      - `transferReference` string, nullable — The unique reference of the transfer. May be null.
      - `currency` string, nullable — The currency of the transfer. May be null.
      - `amountRequested` string, nullable — The amount of the transfer. May be null.

## Other responses

- `404` — Specified resource does not exist

---

[API](https://skmtc.net/fourthline/apis/fourthline-apis.md) · [All operations](https://skmtc.net/fourthline/apis/fourthline-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthline/fourthline-apis/revisions/7991ae7c8383/schema)
