---
title: "FinCEN MSB Registrations Search"
method: POST
path: "/us/fincen/msb-registrations-search/v1"
tags: ["United States", "FinCEN MSB Registrations"]
---

# FinCEN MSB Registrations Search

`POST /us/fincen/msb-registrations-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/us/fincen/msb-registrations-search/v1`
- Auth: HTTP bearer

Search every money services business registered with FinCEN (money transmitters, check cashers, currency exchangers, prepaid access providers, in the US and abroad) by legal name or DBA, registered service, state, the states where it operates, country, whether it operates abroad and the date the filing was received, or its 14-digit MSB registration number; follow one business's filings by `registrant_key`. By legal name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date weekly.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Palabras a buscar en los nombres (opcional).
  - `activity` '' | 'issuer_of_travelers_checks' | 'seller_of_travelers_checks' | 'redeemer_of_travelers_checks' | 'issuer_of_money_orders' | 'seller_of_money_orders' | 'redeemer_of_money_orders' | 'currency_dealer_or_exchanger' | 'check_casher' | 'money_transmitter' | 'travelers_checks_sales_or_redemption' | 'money_orders_sales_or_redemption' | 'us_postal_service' | 'seller_of_prepaid_access' | 'provider_of_prepaid_access' | 'dealer_in_foreign_exchange' | 'other': Actividad MSB declarada, p. ej. `money_transmitter`, `check_casher`, `dealer_in_foreign_exchange`, `seller_of_prepaid_access` (opcional).
  - `state` string: Código de dos letras de un estado o territorio de EE. UU., p. ej. `TX` (opcional).
  - `operates_in` string: Código de dos letras de un estado o territorio de EE. UU., p. ej. `TX` (opcional).
  - `country` string: País de un registrante ubicado fuera de EE. UU., como lo escribe FinCEN, p. ej. `COLOMBIA`, `MEXICO`, `HONG KONG` (opcional).
  - `operates_abroad` boolean: `true` para ver solo los registros que declaran actividad fuera de EE. UU. (opcional).
  - `registrant_key` string: registrant_key de un registro, para ver todas las presentaciones del mismo negocio (opcional).
  - `registration_number` string: Número de registro MSB de FinCEN, catorce dígitos (opcional).
  - `from_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `to_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Resultados por página (1-50).

## Response `200`

Successful response

- FincenMsbRegistrationsSearchResponse
  - `data` FincenMsbRegistrationsSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `activity` string, nullable, required
    - `state` string, nullable, required
    - `operates_in` string, nullable, required
    - `country` string, nullable, required
    - `operates_abroad` boolean, required
    - `registrant_key` string, nullable, required
    - `registration_number` string, nullable, required
    - `from_date` string, nullable, required
    - `to_date` string, nullable, required
    - `total` number, required: Registrations matching the filters, across every page, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `registrations` object[], required
      - `id` string, required: Croma's id for the filing, derived from what the list says about it (the list publishes no number of its own); a counter follows when FinCEN lists the same filing twice. The key.
      - `registrant_key` string, required: The same for every filing of one business (its legal name, street and ZIP), to list a registrant's renewals together.
      - `legal_name` string, required: The business's legal name as registered. FinCEN cuts names at 50 characters.
      - `dba_name` string, nullable, required: The name it does business as.
      - `street_address` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required: The two-letter state of the address; for a registrant abroad, sometimes its province.
      - `zip_code` string, nullable, required
      - `country` string, nullable, required: For a registrant located outside the US, its country as FinCEN writes it, e.g. `COLOMBIA`, `HONG KONG`.
      - `activities` string[], required: The money services the business registered for, e.g. `money_transmitter`, `check_casher`, `dealer_in_foreign_exchange`, `seller_of_prepaid_access`.
      - `activity_codes` string[], required: The same activities as FinCEN's codes, e.g. `409`.
      - `states_of_activity` string[], required: The US states and territories where the business said it operates, as two-letter codes.
      - `activity_scope` string, nullable, required: FinCEN's flag, as written: `A` all states and territories, `B` all states, `C` all territories, `D` foreign, or a combination such as `AD`.
      - `operates_abroad` boolean, required: Whether the business said it operates outside the US (the `D` flag).
      - `branches` integer, nullable, required: The number of branches it reported.
      - `auth_sign_date` string, nullable, required: When the registration was signed (yyyy-mm-dd).
      - `received_date` string, nullable, required: When FinCEN received the registration (yyyy-mm-dd).
      - `registration_number` string, nullable, required: FinCEN's MSB registration number for the filing (14 digits), from its registration letter; null until the letter is read.
      - `registration_type` string, nullable, required: From the registration letter: `Initial Registration`, `Renewal` or another kind FinCEN writes.
      - `document_url` string, nullable, required: Croma's copy of the filing's registration letter (PDF), as FinCEN served it.
      - `source_document_url` string, nullable, required: FinCEN's link to the letter when it was read. FinCEN renumbers these links, so it may no longer answer; `document_url` does.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/74c745980c60?raw)