Skip to content
FinCode

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 an API key from the dashboard. Keys use the sk_ prefix. 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.ecommica.com/v1/iban/validate?iban=DE89370400440532013000" \
  -H "Authorization: Bearer sk_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

Grab a dependency-free client from the SDKs page, browse the endpoint reference for SWIFT, routing and local identifier lookups, or read the error handling guide before you ship to production.