# Fin Codes API – BIC/SWIFT Code Lookup

> Fin Codes API – BIC/SWIFT Code Lookup is a paid API for AI agents from api.fincodesapi.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-11).

Validates and looks up detailed bank information for an 8- or 11-character BIC/SWIFT code, returning bank name, branch, city, address, and country.

## Facts

- Endpoint: POST https://api.fincodesapi.com/x402/bic/lookup?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fin-codes-api-bic-swift-code-lookup-4ffc9635
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xqtSAQAxA_qf4kPysG9YA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fin-codes-api-bic-swift-code-lookup-4ffc9635 -d '<json body>'
```

Example prompt: Can you look up the bank details for the BIC/SWIFT code SOGEDEFF and tell me the bank name, branch, and address?

## When to prefer this

Choose this endpoint when you need to validate or enrich a BIC/SWIFT code with full bank and branch details — especially for pre-payment verification, compliance data enrichment, or onboarding workflows. It is purpose-built for BIC lookup with structured output including address and branch details, making it more useful than a generic bank search.

## Known failure modes

- Invalid or malformed BIC returns an error or success:false
- Unknown BIC not in database returns no data
- Missing required 'bic' field in request body causes a validation error
- Network or payment (x402) authentication failures return HTTP 402 or 4xx errors

## How this service works

Validate IBANs, BIC/SWIFT codes and local bank routing codes worldwide with one REST API. ABA, BSB, IFSC, CLABE, NCC, Canadian routing numbers and more, plus payee verification and sanctions screening.

## Output

A JSON object containing the BIC/SWIFT identifier, the bank's name, code, and country, the branch name and code, the city (with country), the physical address and postcode of the branch, and a success flag indicating whether the code was found and valid.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bic": {
   "type": "string",
   "example": "SOGEDEFF",
   "description": "8- or 11-character BIC/SWIFT code to validate and look up."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "SOGEDEFF",
   "bank": {
    "id": "cfb1758f-1195-4be9-b981-3fc63da7306b",
    "code": "SOGE",
    "name": "SOCIETE GENERALE S.A.",
    "country_id": "DE"
   },
   "city": {
    "id": "c3eb05ae-2709-45c7-9799-d5e2fee08946",
    "name": "Frankfurt Am Main",
    "country_id": "DE"
   },
   "address": "NEUE MAINZER STRASSE 46-50",
   "country": {
    "id": "DE",
    "name": "Germany"
   },
   "postcode": "60311",
   "branch_code": "",
   "branch_name": "SOGEBANK Frankfurt Main"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fin-codes-api-bic-swift-code-lookup-4ffc9635/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fincodesapi.com](https://www.zero.xyz/host/api.fincodesapi.com/llms.txt)