Quickstart

Create an API key and validate your first IBAN in under five minutes.

This documentation covers API V1.

1. Create an API key

Sign up and generate a test key from the dashboard. Keys use the sk_test_ prefix in development and sk_live_ in production. Keys are shown once — store them somewhere safe and rotate them from the dashboard at any time.

2. Make your first request

All requests authenticate with the Authorization header. The example below validates an IBAN and returns the parsed bank code.

bash

curl -s "https://api.fincode.example.com/v1/iban/validate?iban=DE89370400440532013000" \
  -H "Authorization: Bearer sk_test_xxx"

3. Read the response

Every successful response wraps the payload in a data object and echoes a request_id in meta — include it when contacting support.

json

{
  "data": {
    "valid": true,
    "iban": "DE89370400440532013000",
    "country": "DE",
    "check_digits": "89",
    "bank_code": "37040044",
    "account_number": "0532013000",
    "length": 22,
    "expected_length": 22
  },
  "meta": { "request_id": "req_1a2b3c4d" }
}

Next steps

Browse the endpoint reference for SWIFT, routing and local identifier lookups, or read the error handling guide before you ship to production.