Account Holders5

API Keys2

Audit Trails2

balances2

Bank Code Lookup1

post/bank_code_lookupBank code lookup

Bank Simulator5

Bulk Actions4

Claims5

connected-accounts3

Connectivity Syncs2

Counterparties5

Counterparty Accounts8

Credit arrangements6

Custom Fields4

DICT droxy claims1

DICT proxy claims6

DICT proxy keys6

DICT proxy lookup3

Direct Debit Mandates7

Events4

Expected Payments5

External Accounts8

Files5

Incoming Payments7

Inquiries4

Internal Accounts7

Loans8

Message forward2

payee-verification-requests7

Payment Captures5

Payment Orders8

Payment Retry Rules2

Platform Health Check1

Process Payments1

Proxy lookup simulator1

Reconciliations5

Return Requests5

Returns7

transactions3

verification-scheme-participants2

Virtual Accounts6

Bank Code Lookup

Bank code lookup

Retrieve the bank code of the bank holding an account from its IBAN

post/bank_code_lookup

Request

Base URL
https://sandbox.numeral.io/v1
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/numeral/apis/payments/docs/bank_code_lookup/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

account_numberstring required

The IBAN used to identify the associated bank code. In sandbox, every IBAN returns BANKXXPP with XX being the first 2 letters of the IBAN, except for FR5814508000307438479856J64 that returns a functional error.

Example request

{
  "account_number": "FR1112739000503237488219N55"
}

Response

200

bank_codestring required

The bank code associated with the IBAN.

Example response

{
  "bank_code": "BANKFRPP"
}

Changes

No recorded changes to this operation across all 1 revision of this API.