---
title: "Resolve bank identifiers"
method: POST
path: "/bank-intelligence/lookup"
---

# Resolve bank identifiers

`POST /bank-intelligence/lookup`

## Request

- Base URL: `https://ibangen.com/api/v1`
- URL: `https://ibangen.com/api/v1/bank-intelligence/lookup`
- Auth: API key in header `X-API-Key`

Look up BIC, domestic identifiers or other supported registry values. Send one value/type pair or an identifiers array; plan limits and provenance fields are applied server-side.

## Request body

- BankIntelligenceLookupRequest
  - `value` string: Single identifier shortcut.
  - `type` string
  - `identifiers` BankIdentifier[]
    - `value` string, required
    - `type` string

## Response `200`

Matched registry records

- BankIntelligenceResponse
  - `success` boolean
  - `results` object[]
  - `record` object
  - `count` integer
  - `registry_generated_at` string, date-time
  - `charged_api_credits` integer

## Other responses

- `400`: Invalid identifier list or plan limit
- `401`: Invalid API key
- `429`: API credits exhausted

---

[API](https://skmtc.dev/ibangen/apis/ibangen-api.md) · [All operations](https://skmtc.dev/ibangen/apis/ibangen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ibangen/apis/ibangen-api/revisions/50b475482b4d?raw)