Validate an account number and identify its bank

Checks the MOD-11 check digit of a Norwegian account number (or the MOD-97 check digits of an IBAN), converts between BBAN and IBAN, and resolves the owning bank. A syntactically valid number is not proof that the account exists.

POST/v1/accounts/validate

Authorization

Optional — this operation also accepts unauthenticated requests.

x-api-keyAPI key · header

API key issued from the dashboard. Optional: anonymous callers are served at a lower rate limit.

AuthorizationBearer token · header

The same API key, sent as a bearer token.

Request body

requiredapplication/json

accountNumberstringrequired

Norwegian account number (11 digits, any separators) or an IBAN

min length 4 · max length 34

Responses

200Default Response

accountAccountrequired

Show properties

validbooleanrequired

bbanstring | anyrequired

Show properties

Any of:

string

string

any

any

formattedstring | anyrequired

Show properties

Any of:

string

string

any

any

ibanstring | anyrequired

Show properties

Any of:

string

string

any

any

ibanFormattedstring | anyrequired

Show properties

Any of:

string

string

any

any

clearingCodestring | anyrequired

Show properties

Any of:

string

string

any

any

errorobject | anyrequired

Why the account number was rejected

Show properties

Any of:

object

codestringrequired

messagestringrequired

any

any

bankBank | anyrequired

Show properties

Any of:

Bank

bicstringrequired

ISO 9362 BIC, 8 or 11 characters

matches ^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$

institutionCodestringrequired

First four BIC characters

namestringrequired

countrystringrequired

clearingCodesstring[]required

logoBankLogo | anyrequired

Show properties

Any of:

BankLogo

formatsstring[]required

hashstringrequired

urlstring<uri>required

Immutable URL for the preferred format

any

any

any

any

400Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

401Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

404Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

429Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

500Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

Request

curl -X POST "http://localhost:8080/v1/accounts/validate" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "accountNumber": "8601 11 17947"
}'

const response = await fetch("http://localhost:8080/v1/accounts/validate", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "accountNumber": "8601 11 17947"
})
});

import requests

response = requests.post(
    "http://localhost:8080/v1/accounts/validate",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
  "accountNumber": "8601 11 17947"
},
)

Response

{
  "account": {
    "valid": true,
    "bban": "86011117947",
    "formatted": "8601 11 17947",
    "iban": "NO9386011117947",
    "ibanFormatted": "NO93 8601 1117 947",
    "clearingCode": "1503",
    "error": {
      "code": "string",
      "message": "string"
    }
  },
  "bank": {
    "bic": "DNBANOKK",
    "institutionCode": "DNBA",
    "name": "DNB Bank ASA",
    "country": "NO",
    "clearingCodes": [
      "1503"
    ],
    "logo": {
      "formats": [
        "svg"
      ],
      "hash": "string",
      "url": "http://example.com"
    }
  }
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}