# Iban Get {iban}

> Validates an IBAN and returns the country, bank code, and account number. Spaces in the input are stripped automatically. Always returns HTTP 200 — check the valid field to determine whether the IBAN is valid.

- Skill: `gabrielmoreira/iban-get-iban` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/iban-get-iban`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/iban-get-iban/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/iban-get-iban

---


## Endpoint

**GET https://requiems.xyz/v1/finance/iban/{iban}**

## Validate IBAN

Validates an IBAN and returns the country, bank code, and account number. Spaces in the input are stripped automatically. Always returns HTTP 200 — check the valid field to determine whether the IBAN is valid.

## Parameters

| Name | Type | Required | Location | Description |
| ---- | ---- | -------- | -------- | ----------- |
| `iban` | string | yes | path | The IBAN to validate. Spaces are stripped. Case-insensitive. |

## Response Example

```json
{
  "data": {
    "iban": "DE89370400440532013000",
    "valid": true,
    "country": "Germany",
    "bank_code": "37040044",
    "account": "0532013000"
  },
  "metadata": {
    "timestamp": "2026-01-01T00:00:00Z"
  }
}
```

## Response Fields

| Field | Type | Description |
| ----- | ---- | ----------- |
| `iban` | string | The normalised IBAN (spaces stripped, uppercased) |
| `valid` | boolean | true if the IBAN passed length and ISO 13616 checksum validation |
| `country` | string | Full country name (empty if the country code is not in the registry) |
| `bank_code` | string | Bank identifier extracted from the BBAN (empty if country not in registry or positions not defined) |
| `account` | string | Account number extracted from the BBAN (empty if country not in registry or positions not defined) |

## Errors

- `500` **internal_error** — Unexpected server error (e.g. database unreachable).