Name: Financial Firm Register Search API — bank & broker licence.
Brand: 193market
SKU: api-193market-financial-firm-register-search
Availability: InStock
Author: API Market

# Financial Firm Register Search API

## Overview

The Financial Firm Register Search API answers whether a financial institution appears on an official regulator register. It searches across multiple national registers at once — such as the US FDIC and the Australian APRA register of authorised deposit-taking institutions — and returns scored matches with the register each one came from, so you can see both that a firm is listed and who lists it.

It is built for compliance and onboarding teams screening counterparties, and for anti-fraud checks on firms claiming to be regulated. Matches are scored and typed, including matches on former or alternate names, and the response reports data freshness and attribution alongside the result.

## Features

*   **Multi-Register Search:** One query runs across the supported national regulator registers.
*   **Scored Matching:** Each result carries a `match_score` and a `match_type` such as `full_name`.
*   **Alternate Name Matching:** Matches on former and trading names, reporting which name matched via `matched_on`.
*   **Identifier Lookup:** Resolve a firm directly by identifier type and value with `/v1/lookup`.
*   **Register Transparency:** `/v1/registers` lists every register covered, with country and regulator.
*   **Freshness Reporting:** Responses include data freshness and attribution, and `max_register_age_days` can bound how stale a register may be.

## Use Cases

*   **Counterparty Screening:** Confirm a firm is on an official register before onboarding it.
*   **Anti-Fraud Checks:** Test claims of regulated status against the actual register.
*   **Compliance Records:** Capture the matching register and freshness alongside the decision.
*   **Reference Data:** Enumerate covered registers to scope your own process.

## API Documentation

### Base URL

All API requests for the Financial Firm Register Search API should be made to the following base URL:

```
https://prod.api.market/api/v1/193market/financial-firm-register-search
```

### Authentication

Authentication is handled via an API key. You must include your key in the `x-api-market-key` header of every request:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Service Health

Health check

**Method:** `GET`
**Endpoint:** `/health`

**Example Response (200 OK):**

```json
{
  "ok": true,
  "meta": {
    "built_at": "2026-09-19T03:03:15+00:00",
    "institutions": "55558"
  },
  "registers_failing_last_build": [],
  "refresh": {
    "last_run": "2026-09-19",
    "last_ok": {
      "au_apra_adi": {
        "records": 126,
        "active": 126,
        "as_of": "2026-08-10",
        "quarantined": 0
      },
      "au_asic_afs": {
        "records": 6466,
        "active": 6466,
        "as_of": "2026-09-16",
        "quarantined": 0
      },
      "au_asic_credit": {
        "records": 3933,
        "active": 3927,
        "as_of": "2026-09-10",
        "quarantined": 0
      },
      "ca_osfi": {
        "records": 343,
        "active": 343,
        "as_of": "2026-09-01",
        "quarantined": 0
      },
      "eu_ecb_mfi": {
        "records": 4938,
        "active": 4938,
        "as_of": "2026-09-18",
        "quarantined": 0
      },
      "jp_fsa": {
        "records": 10256,
        "active": 10256,
        "as_of": "2026-09-07",
        "quarantined": 0
      },
      "kr_fsc": {
        "records": 912,
        "active": 912,
        "as_of": "2026-09-16",
        "quarantined": 0
      },
      "kr_kdic": {
        "records": 284
  …
```

#### 2. Check a Firm by Name

Is this financial firm on a regulator's register?

**Method:** `GET`
**Endpoint:** `/v1/check`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `name` | query | Firm name in any script, e.g. Mizuho Bank, 우리은행 or 台灣銀行 | `string` | Yes |  | `200` |
| `country` | query | Optional ISO country code, e.g. JP | `string` | No |  |  |
| `include_inactive` | query | Also return cancelled, closed or merged registrations | `boolean` | No | `false` |  |
| `threshold` | query | Minimum match score 0.5–1.0 (default 0.8) | `number` | No | `0.8` |  |
| `limit` | query | Maximum results, 1–25 | `integer` | No | `10` |  |
| `max_register_age_days` | query | Skip register copies older than this many days, e.g. 365 | `integer` | No |  |  |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/financial-firm-register-search/v1/check?name=Barclays&limit=2" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{"query":{"name":"Barclays","normalised":"BARCLAYS","country":null,"include_inactive":false,"threshold":0.8,"max_register_age_days":null},"found":true,"best_score":1.0,"score_version":"2026-09-17","coverage":{"country":null,"registers_searched":11,"covered":true,"registers":["AU · Australian Prudential Regulation Authority · Register of authorised deposit-taking institutions","AU · Australian Securities and Investments Commission · Australian financial services licensees","AU · Australian Securities and Investments Commission · Australian credit licensees","CA · Office of the Superintendent of Financial Institutions · Who we regulate — federally regulated financial institutions","EU · European Central Bank · List of Monetary Financial Institutions (MFIs), daily","JP · Financial Services Agency (Japan) · List of licensed (registered) financial institutions","KR · Financial Services Commission (Korea) · Financial company basic information (금융회사기본정보), data.go.kr dataset 15043232","KR · Korea Deposit Insurance Corporation · Insured financial institutions (부보금융회사 목록), data.go.kr file dataset 15083240","TW · Central Deposit Insurance Corporation (Taiwan) · List of deposit-insured institu
  …
```

#### 3. Look Up a Firm by Identifier

Find registrations by an identifier such as an LEI

**Method:** `GET`
**Endpoint:** `/v1/lookup`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `id_type` | query | Identifier type, e.g. lei, rssd, fdic_cert, abn, afsl, kr_crno, kr_bzno. Full list: GET /v1/registers | `string` | Yes |  |  |
| `value` | query | Identifier value; spaces and dashes are ignored | `string` | Yes |  | `40` |
| `max_register_age_days` | query | Skip register copies older than this many days | `integer` | No |  |  |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/financial-firm-register-search/v1/lookup?id_type=lei&value=213800LBQA1Y9L22JB70" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "query": {
    "id_type": "lei",
    "value": "213800LBQA1Y9L22JB70"
  },
  "found": false,
  "results": [],
  "data_freshness": {
    "built_at": "2026-09-19T03:03:15+00:00",
    "note": "each result carries its register's own as_of date"
  },
  "attribution": {
    "sources": "Each result names the regulator and register it comes from, with the register's own licence and a link to confirm it. Full list: GET /v1/registers.",
    "changes": "Fields renamed to English keys, names normalised for matching, personal names, phone numbers and street addresses removed, individuals removed.",
    "free_of_charge": "The register information in this API may be obtained free of charge from each regulator's website (register_url in every result), including the ECB list of MFIs at www.ecb.europa.eu. You pay for the search, matching, cleaning and API, not for the information itself.",
    "notice": "Not affiliated with or endorsed by any regulator. For screening only: this API does not certify that a firm is licensed or authorised. Registers are copied as published and may lag the regulator's live systems. Not being found is not proof that a firm is unregulated or unlawful; a match is not pr
  …
```

#### 4. Get Institution Record

One registration by its id

**Method:** `GET`
**Endpoint:** `/v1/institutions/{institution_id}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `institution_id` | path | — | `string` | Yes |  |  |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/financial-firm-register-search/v1/institutions/us_fdic:57203" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "institution": {
    "id": "us_fdic:57203",
    "name": "Barclays Bank Delaware",
    "name_local": null,
    "other_names": [
      "Juniper Bank",
      "Barclays",
      "Barclaycard US",
      "Best Egg Inc."
    ],
    "country": "US",
    "city": "Wilmington, DE",
    "institution_type": "Commercial bank, state charter, Fed non-member (FDIC-supervised)",
    "status": "active",
    "status_detail": "Open and insured by the FDIC; primary regulator: Federal Deposit Insurance Corporation",
    "authorised_since": "2001-05-23",
    "status_changed": null,
    "identifiers": {
      "fdic_cert": "57203",
      "rssd": "2980209",
      "lei": "C7HX62OF36KBJB6QPK73"
    },
    "website": "www.barclaysus.com/deposits",
    "register": {
      "id": "us_fdic",
      "country": "US",
      "regulator": "Federal Deposit Insurance Corporation",
      "register": "BankFind Suite — institutions",
      "meaning": "The institution holds (active) or held (inactive) FDIC deposit insurance at the source date",
      "register_url": "https://banks.data.fdic.gov/bankfind-suite/bankfind",
      "licence": "Public domain (U.S. Government work, usa.gov)"
    },
    "register_as_of": "2026-09-11
  …
```

#### 5. List Supported Registers

Which registers are covered, how fresh, what they mean

**Method:** `GET`
**Endpoint:** `/v1/registers`

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/financial-firm-register-search/v1/registers" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{"registers":[{"id":"au_apra_adi","country":"AU","regulator":"Australian Prudential Regulation Authority","register":"Register of authorised deposit-taking institutions","meaning":"Authorised by APRA as a deposit-taking institution under the Banking Act 1959 at the page's update date","register_url":"https://www.apra.gov.au/registers/list-registered-authorised-deposit-taking-institutions","licence":"Creative Commons Attribution 4.0 International (apra.gov.au copyright page)","records":126,"active_records":126,"as_of":"2026-08-10","stale":false,"stale_records":0,"built_at":"2026-09-19T03:03:15+00:00","last_build_ok":true,"identifier_types":{}},{"id":"au_asic_afs","country":"AU","regulator":"Australian Securities and Investments Commission","register":"Australian financial services licensees","meaning":"Holds a current Australian financial services licence issued by ASIC at the file date","register_url":"https://connectonline.asic.gov.au/RegistrySearch/faces/landing/ProfessionalRegisters.jspx","licence":"Creative Commons Attribution 3.0 Australia","records":6466,"active_records":6466,"as_of":"2026-09-16","stale":false,"stale_records":0,"built_at":"2026-09-19T03:03:15+00:00","last_bui
  …
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| `200` | OK | The request succeeded and data has been returned. |
| `400` | Bad Request | The request contains invalid parameters or a malformed query. Review your request syntax. |
| `401` | Unauthorized | The `x-api-market-key` header is missing or contains an invalid key. |
| `403` | Forbidden | Your API key is valid but the origin rejected the request. |
| `404` | Not Found | The requested endpoint or record does not exist. Verify the URL path and identifier. |
| `429` | Too Many Requests | You have used all the API units included in your plan, or exceeded the per-second rate. See the Rate Limits section. |
| `500` | Internal Server Error | An unexpected server-side error occurred. Retry the request after a brief delay. |
| `503` | Service Unavailable | The service is temporarily unavailable. Retry with exponential backoff. |

## Rate Limits

The Basic plan includes 30 API units, Pro 1,000, Ultra 5,000 and Mega 25,000, each with a hard limit. When the included units are used up the API returns `429 Too Many Requests` until the plan renews. Use `limit` to keep result sets small on bulk screening runs.

## FAQ

*   **What does `match_type` tell me?**
    How the match was made — `full_name` for an exact name match, with `matched_on` naming which stored name matched, such as `other_name` for a former or trading name.

*   **How do I control match strictness?**
    Use `threshold`. It defaults to 0.8; raise it to reduce false positives and lower it to catch more name variants.

*   **What identifier types does lookup accept?**
    Pass the type in `id_type` and the value in `value`. Institution identifiers returned by `/v1/check` are namespaced by register, for example `us_fdic:57203`.

*   **Does a match mean the firm is currently authorised?**
    It means the firm appears on that register. Check the record and the freshness fields for the status and age of the underlying data.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Check whether a bank, insurer or broker is on a regulator's register in the US, Japan, Australia, the EU, Korea, Taiwan or Canada. Name search in any script.

Financial Firm Register Search API — bank & broker licence.

Basic