apyhub
DATA VALIDATION · FINANCE

BIC Validator

What it does

BIC Validator checks whether a BIC / SWIFT code is structurally valid and returns the code parts you can use in downstream banking workflows.

Send a bic value in the request body. BIC Validator returns either a simple false for an invalid code, or a structured object with valid, bank_code, branch_code, country_code, and location_code when the code parses correctly. That makes it useful when you need to reject malformed payment details before they reach your transfer, onboarding, or account setup logic.

Use it in checkout flows, bank beneficiary forms, KYC steps, or backend validation jobs where you want to confirm that a SWIFT identifier follows the expected format. Because the response is limited to the fields in the schema, you can wire it directly into validation rules without guessing at extra bank metadata.

POST
Validate a BIC / SWIFT code
https://api.eu.apyverse.com/apyhub/validate-bic

QUICKSTART

GUIDE

Quickstart

Validate a BIC/SWIFT code by sending it in a simple JSON request body.

curl -X POST "https://api.eu.apyverse.com/apyhub/validate-bic" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"bic":"ABNANL2A"}'

What you'll get back

Returns a JSON object with a data field. data can be either a boolean false when the BIC is invalid, or an object with validation details such as valid, bank_code, branch_code, country_code, and location_code.

{
  "data": {
    "valid": true,
    "bank_code": "ABNA",
    "branch_code": "",
    "country_code": "NL",
    "location_code": "2A"
  }
}
TRY ITLIVE · 5 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
BIC/SWIFT code to validate (8 or 11 characters).

About this endpoint

What it does

Validates a BIC/SWIFT code sent in the request body. The response returns a data field that is either a detailed object for a valid code or false when the BIC is invalid.

Request Body

ParameterTypeMandatoryDescription
bicStringYesBIC/SWIFT code to validate. Must be 8 or 11 characters.

Response

Returns a JSON object with a required data field. data is either a boolean false when the BIC is invalid, or an object containing validation details for a valid BIC.

ParameterTypeMandatoryDescription
dataObject / BooleanYesEither false when the BIC is invalid, or an object with validation details.
data.validBooleanNoIndicates whether the BIC is valid.
data.bank_codeStringNoBank code extracted from the BIC.
data.branch_codeStringNoBranch code extracted from the BIC.
data.country_codeStringNoCountry code extracted from the BIC.
data.location_codeStringNoLocation code extracted from the BIC.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.