---
title: "Reverse-look a BIC up: a BIC8 returns every branch, head office first; a BIC11 that branch alone (public)."
method: GET
path: "/api/v2/institutions/bics/{bic}"
---

# Reverse-look a BIC up: a BIC8 returns every branch, head office first; a BIC11 that branch alone (public).

`GET /api/v2/institutions/bics/{bic}`

## Request

- Base URL: `https://fintable.io`
- URL: `https://fintable.io/api/v2/institutions/bics/{bic}`
- Auth: none required

`meta` carries `source`, `notice` (SWIFT's database-rights notice, to be reproduced with any copy of the data), `valid_as_of` (the directory's publication date), `last_updated` (its newest record update) and `entries`.

## Path parameters

- `bic` string, required

## Response `200`

A {"data": [BicEntry...], "meta": {...}} envelope.

- object
  - `data` BicEntry[], required
    - `bic` string, required: The full BIC11 (BIC8 + branch code).
    - `bic8` string, required
    - `branch` string, required: Three-character branch code; XXX is the head office.
    - `head_office` boolean, required
    - `is_active_swift` boolean, required: Whether the BIC is active on the SWIFT network, read from the code's location character as SWIFT defines it: an 8th character of 1 marks a passive, unconnected BIC and 0 a test BIC.
    - `test_bic` boolean, required: A test-and-training BIC (8th character 0).
    - `name` string, required: The institution's full legal name.
    - `country` string, required: ISO 3166-1 alpha-2, from the code itself.
    - `registered_address` string, nullable, required
    - `operational_address` string, nullable, required
    - `branch_description` string, nullable, required
    - `branch_address` string, nullable, required
    - `institution_type` string, nullable, required: FIIN for a financial institution, NFIN for a non-financial one.
    - `record_creation_date` string, date, nullable, required: When SWIFT created the record.
    - `last_update_date` string, date, nullable, required: When SWIFT last updated the record.
  - `meta` object, required
    - `source` string, required
    - `notice` string, required
    - `valid_as_of` string, date, nullable, required
    - `last_updated` string, date, nullable, required
    - `entries` integer, required

## Other responses

- `404`: The standard error envelope.

---

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