Docs / Checks

Validate an IBAN

Checks the IBAN format and checksum. An invalid IBAN still returns 200. This does not ask a bank whether the account exists.

POST/v1/iban/validate

import { Client } from "@liveapiio/liveapi";

const client = new Client({ token: process.env.LIVEAPI_TOKEN });

const iban = await client.validateIban("TR33 0006 1005 1978 6457 8413 26");

Request

Send Authorization: Bearer YOUR_TOKEN. The token stays on your server. Each library reads it from the environment and calls this endpoint for you.

Field	Type	Description
iban	string	The IBAN, with or without spaces. Required.

Response

200 with valid: false means the format or checksum failed. That response still uses one call.

Errors

A failed request returns { "error": { "code", "message" } } and does not use a call.

Status	Code	When
400	invalid_request	A required field is missing or has the wrong type.
401	unauthorized	The bearer token is missing or not recognized.