---
title: "List Virtual IBANs"
method: GET
path: "/v3/iban/list-iban"
tags: ["IBAN"]
---

# List Virtual IBANs

`GET /v3/iban/list-iban`

Retrieve a paginated list of virtual IBANs.

## Query parameters

- `userId` string
- `currency` string
- `limit` integer
- `page` integer

## Headers

- `MID` string, required

## Response `200`

Virtual IBANs listed successfully

- object
  - `status` string
  - `message` string
  - `data` object[]
    - `ibId` string
    - `userId` string
    - `status` string
    - `iban` string
    - `bic` string
    - `currency` string
    - `bankName` string
    - `accountType` string
    - `entityName` string
    - `assigned` boolean
    - `issuedFor` 'organization' | 'individual'
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `pagination` object
    - `total` integer
    - `pages` integer
    - `currentPage` integer
    - `limit` integer
    - `hasNext` boolean
    - `hasPrev` boolean

## Other responses

- `400` — Validation error or page out of limit
- `500` — Internal server error

---

[API](https://skmtc.net/transfi/apis/transfi-single-integrated-api.md) · [All operations](https://skmtc.net/transfi/apis/transfi-single-integrated-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfi/transfi-single-integrated-api/revisions/adb1b62e58cf/schema)