メインコンテンツへスキップ
GET
/
v1
/
bic
BIC検証
curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/bic/
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
はじめに

​
ベースURL

https://bankvalidation.cleariflow.com/v1/bic/

​
検証エンドポイント

bicエンドポイントには、APIキーとBICパラメータが必要です。ビジネス識別コード（BIC）の包括的な検証を行います。 
https://bankvalidation.cleariflow.com/v1/bic/
? api_key = YOUR_UNIQUE_API_KEY
& bic = DEUTDEFF500
この成功したリクエストは、ドイツのBICを検証し、詳細情報を返します。 
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
リクエストパラメータ

​
api_key
String
必須
固有のAPIキーです。各ユーザーはCleariflowの各APIごとに固有のAPIキーを持っているため、銀行検証APIのキーは為替レートAPIなどでは動作しません。
​
bic
String
必須
検証するビジネス識別コード（BIC）です。スペースは許可され、処理中に自動的に削除されます。BICはISO 9362標準フォーマットに従う必要があります。

​
レスポンスパラメータ

APIレスポンスは、汎用的で軽量な JSON形式 で返されます。
​
bic
String
スペースを除いた正規化されたBICで、大文字形式で返されます。
​
is_valid
Boolean
すべての検証ルールに従ってBICが有効かどうかを示す総合的な検証結果です。
​
country_code
String
2文字のISO国コードです（例：ドイツはDE、米国はUS）。
​
country_name
String
BICに関連する国の正式名称です。
​
bank_code
String
4文字の銀行識別コードです（例：ドイツ銀行はDEUT）。
​
bank_name
String
The name of the bank (currently shows “Bank information not available”).
​
location_code
String
都市または地域を示す2文字のロケーションコードです（例：フランクフルトはFF）。
​
branch_code
String
3文字の支店コードです（オプション、8文字BICでは空の場合があります）。
​
details
Object
BICのタイプとステータスに関する追加の詳細情報です。
​
details.type
String
識別子のタイプです（通常は「BIC」）。
​
details.active
Boolean
BICが現在有効で使用中かどうかです。
​
details.institution_type
String
金融機関のタイプです（例：「Bank」「Credit Union」）。

​
例

​
有効なドイツのBIC（8文字）

リクエスト： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF
レスポンス： 
{
  "bic": "DEUTDEFF",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "FF",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
有効なドイツのBIC（支店付き11文字）

リクエスト： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF500
レスポンス： 
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "FF",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
有効な米国のBIC

リクエスト： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=CHASUS33
レスポンス： 
{
  "bic": "CHASUS33",
  "is_valid": true,
  "country_code": "US",
  "country_name": "United States",
  "bank_code": "CHAS",
  "bank_name": "Bank information not available",
  "location_code": "33",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
有効な英国のBIC

リクエスト： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=NWBKGB2L
レスポンス： 
{
  "bic": "NWBKGB2L",
  "is_valid": true,
  "country_code": "GB",
  "country_name": "United Kingdom",
  "bank_code": "NWBK",
  "bank_name": "Bank information not available",
  "location_code": "2L",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
無効なBIC

リクエスト： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=INVALID
レスポンス： 
{
  "bic": "INVALID",
  "is_valid": false,
  "country_code": "",
  "country_name": "",
  "bank_code": "",
  "bank_name": "Bank information not available",
  "location_code": "",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true
  }
}

​
エラーハンドリング

​
BICパラメータの欠落

リクエスト： 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY
レスポンス： 
{
  "error": {
    "message": "Missing bic",
    "code": "missing_bic"
  }
}

​
APIキーの欠落

リクエスト： 
GET https://bankvalidation.cleariflow.com/v1/bic/?bic=DEUTDEFF500
レスポンス： 
{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key"
  }
}

​
BICの構造

BICはいくつかのコンポーネントで構成されます：
  1. 銀行コード（4文字）：金融機関の固有識別子
  2. 国コード（2文字）：ISO 3166-1 alpha-2国コード
  3. ロケーションコード（2文字）：都市または地域の識別子
  4. 支店コード（3文字）：オプションの支店識別子（本店はXXX）

​
フォーマット例

  • 8文字BIC：DEUTDEFF（ドイツ銀行、ドイツ、フランクフルト）
  • 11文字BIC：DEUTDEFF500（ドイツ銀行、ドイツ、フランクフルト、支店500）

​
一般的なロケーションコード

  • FF：ドイツ・フランクフルト
  • 33：米国・ニューヨーク
  • 2L：イギリス・ロンドン
  • PP：フランス・パリ
  • MM：イタリア・ミラノ

​
検証ルール

APIは次を含む包括的な検証を実行します：
  1. 長さの検証：BICが8文字または11文字か確認
  2. フォーマット検証：BICがISO 9362標準に従っているか確認
  3. 文字検証：英数字のみが使用されていることを確認
  4. 国コード検証：国コードのフォーマットを検証
  5. 銀行コード検証：銀行識別子のフォーマットを確認

​
BICフォーマット要件

  • 銀行コード：4文字の英数字
  • 国コード：2文字のアルファベット（ISO 3166-1）
  • ロケーションコード：2文字の英数字
  • 支店コード：3文字の英数字（オプション）

​
BICとSWIFT

BIC (Business Identifier Code) and SWIFT are often used interchangeably:
  • BIC：公式のISO 9362標準名
  • SWIFT：このコードを普及させたメッセージングネットワーク
  • SWIFTコード：BICの別名
すべてのBICはSWIFTメッセージングに使用できますが、すべてのSWIFTコードが有効なBICであるとは限りません。

​
サポート対象国

APIは50か国以上のBIC検証をサポートしており、以下を含みます：
  • ヨーロッパ：ドイツ、フランス、イタリア、スペイン、オランダ、ベルギー、オーストリア、スイス、英国、ポーランド
  • アメリカ大陸：米国、カナダ、ブラジル、メキシコ
  • アジア：日本、シンガポール、香港、オーストラリア
  • アフリカ：南アフリカ、エジプト、ナイジェリア
サポート対象国の完全なリストは サポート対象国 ページを参照してください。

​
ユースケース

BIC検証は次の用途で不可欠です：
  1. 国際送金：正確なルーティング情報の確保
  2. SEPA決済：欧州決済システムの要件
  3. 銀行アプリケーション：顧客口座の検証
  4. 金融コンプライアンス：規制報告要件
  5. 決済処理：eコマースおよびフィンテックアプリケーション