---
title: "Validate International IBANs and obtain essential information"
method: GET
path: "/lookup/iban/{iban}"
tags: ["Lookup"]
---

# Validate International IBANs and obtain essential information

`GET /lookup/iban/{iban}`

## Request

- Base URL: `https://v2.greipapi.com`
- URL: `https://v2.greipapi.com/lookup/iban/{iban}`
- Auth: HTTP bearer

This method enables you to validate International Bank Account Numbers (IBANs) and obtain essential information about the country associated with each IBAN.

By using this API, you can ensure that the IBANs are formatted correctly and gain insights into the banking institution, enhancing security and accuracy in financial transactions.

## Path parameters

- `iban` string, required

## Query parameters

- `format` string
- `mode` string
- `source` string
- `user_id` string

## Response `200`

OK

- GreipJsonSuccessEnvelope
  - `success` boolean, required
  - `data` object, required: Endpoint-specific payload.
  - `execution_ms` integer, required

## Changes

- **2026-11-03** `5ef5b288383a`: 2 info
  - api tag `Lookup` added
  - added the media type `application/json` for the response with the status `200`
- **2026-10-19** `9346ce4dfd7c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/greip/apis/greip-api/changes/lookup/iban/:iban/get.md)

---

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