> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registros MSB de FinCEN

> Todo negocio de servicios monetarios registrado ante FinCEN: transmisores de dinero, cambiadores de cheques, casas de cambio y proveedores de acceso prepagado, en EE. UU. y en el exterior. Busca por nombre o DBA, servicio, estado, dónde opera, país y fecha de presentación, y sigue las presentaciones de un negocio.

Según la Bank Secrecy Act, un negocio de servicios monetarios debe
registrarse ante la Financial Crimes Enforcement Network, la unidad de
inteligencia financiera del Tesoro de Estados Unidos, y renovar el registro
cada dos años. Los bancos revisan la lista antes de atender a uno. FinCEN
publica cada registro que tiene, incluidos los de negocios ubicados fuera de
EE. UU. que atienden a clientes estadounidenses.

Unas 33.000 presentaciones de cerca de 32.000 negocios, recibidas desde enero
de 2024: quiénes son, dónde están, los servicios para los que se registraron,
los estados donde operan, si operan en el exterior, sus sucursales y cuándo se
firmó y recibió el registro, y el número de registro MSB y la carta de
registro de cada presentación. Se actualiza cuando FinCEN actualiza la lista,
cada semana.

| `activity`                             | Código FinCEN | Servicio                                |
| -------------------------------------- | ------------- | --------------------------------------- |
| `money_transmitter`                    | 409           | Transmisor de dinero                    |
| `check_casher`                         | 408           | Cambiador de cheques                    |
| `currency_dealer_or_exchanger`         | 407           | Casa de cambio de divisas               |
| `dealer_in_foreign_exchange`           | 415           | Operador de divisas                     |
| `issuer_of_money_orders`               | 404           | Emisor de giros postales (money orders) |
| `seller_of_money_orders`               | 405           | Vendedor de giros postales              |
| `redeemer_of_money_orders`             | 406           | Pagador de giros postales               |
| `issuer_of_travelers_checks`           | 401           | Emisor de cheques de viajero            |
| `seller_of_travelers_checks`           | 402           | Vendedor de cheques de viajero          |
| `redeemer_of_travelers_checks`         | 403           | Pagador de cheques de viajero           |
| `seller_of_prepaid_access`             | 413           | Vendedor de acceso prepagado            |
| `provider_of_prepaid_access`           | 414           | Proveedor de acceso prepagado           |
| `travelers_checks_sales_or_redemption` | 410           | Venta o pago de cheques de viajero      |
| `money_orders_sales_or_redemption`     | 411           | Venta o pago de giros postales          |
| `us_postal_service`                    | 412           | Servicio Postal de EE. UU.              |
| `other`                                | 499           | Otro                                    |

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar registros

`POST /us/fincen/msb-registrations-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Busca en todos los registros por cualquier combinación de nombre, servicio,
lugar y fecha de presentación.

| Campo                 | Tipo    | Notas                                                                                                                         |
| --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `query`               | string  | Opcional. Palabras del nombre legal o del DBA. Todas deben coincidir; sin lematización.                                       |
| `activity`            | enum    | Opcional. Un servicio registrado, por el código de la tabla de arriba, p. ej. `money_transmitter`.                            |
| `state`               | string  | Opcional. El estado de dos letras de la dirección del negocio, p. ej. `TX`.                                                   |
| `operates_in`         | string  | Opcional. Un estado o territorio de EE. UU. de dos letras donde el negocio declaró operar, p. ej. `FL`.                       |
| `country`             | string  | Opcional. Para un negocio ubicado fuera de EE. UU., su país como lo escribe FinCEN, p. ej. `COLOMBIA`, `MEXICO`, `HONG KONG`. |
| `operates_abroad`     | boolean | Opcional. `true` para ver solo los registros que declaran actividad fuera de EE. UU. Por defecto `false`.                     |
| `registrant_key`      | string  | Opcional. El `registrant_key` de un registro, para listar todas las presentaciones de ese negocio.                            |
| `registration_number` | string  | Opcional. El número de registro MSB de FinCEN, de 14 dígitos, como aparece en la carta de registro.                           |
| `from_date`           | string  | Opcional. Fecha más temprana en que FinCEN recibió la presentación, yyyy-mm-dd.                                               |
| `to_date`             | string  | Opcional. Fecha más tardía en que FinCEN recibió la presentación, yyyy-mm-dd.                                                 |
| `page`                | integer | Opcional. Página, empieza en 1. Por defecto `1`.                                                                              |
| `per_page`            | integer | Opcional. Resultados por página, 1-50. Por defecto `20`.                                                                      |

```bash theme={"dark"}
curl https://api.croma.run/us/fincen/msb-registrations-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "remesas", "activity": "money_transmitter" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` (coincidencias en todas las páginas), `page`, `per_page`, `total_pages`, `count` y `registrations[]`, por nombre legal.

Cada registro incluye `id` (la clave), `registrant_key` (el mismo en todas las presentaciones de un negocio), `legal_name`, `dba_name`, `street_address`, `city`, `state`, `zip_code`, `country` (para un negocio ubicado fuera de EE. UU.), `activities[]` (la tabla de arriba), `activity_codes[]` (los códigos de FinCEN), `states_of_activity[]` (códigos de dos letras), `activity_scope` (la marca de FinCEN: `A` todos los estados y territorios, `B` todos los estados, `C` todos los territorios, `D` extranjero, o una combinación), `operates_abroad`, `branches`, `auth_sign_date`, `received_date`, `registration_number` (el número de registro MSB de FinCEN, de 14 dígitos), `registration_type` (p. ej. `Initial Registration`, `Renewal`), `document_url` (nuestra copia de la carta de registro de la presentación, un PDF) y `source_document_url` (el enlace de FinCEN a la carta cuando se leyó).

Los campos vacíos son `null`. Una fila es una presentación: un negocio que renovó su registro aparece una vez por presentación, y `registrant_key` las agrupa. FinCEN corta los nombres legales a 50 caracteres. El número y el tipo de registro vienen de la carta de registro de la presentación, que se lee una vez cuando la presentación aparece, así que una presentación recibida en los últimos días puede no tenerlos todavía. El enlace propio de FinCEN a una carta cambia con el tiempo; `document_url` no.

<Warning>
  En palabras de FinCEN: "The inclusion of a business in the MSB Registrant
  Search is not a recommendation, certification of legitimacy, or endorsement
  of the business by any government agency." La lista refleja solo lo que cada
  registrante declaró a FinCEN, no todos los negocios registrados aparecen, y
  el registro no es una licencia: las licencias de los negocios de servicios
  monetarios las otorgan los estados.
</Warning>

## Un registro

`POST /us/fincen/msb-registration/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Resuelve un registro por su id y devuelve el registro completo.

| Campo | Tipo   | Notas                                                             |
| ----- | ------ | ----------------------------------------------------------------- |
| `id`  | string | **Obligatorio.** El id del registro como lo devuelve la búsqueda. |

```bash theme={"dark"}
curl https://api.croma.run/us/fincen/msb-registration/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "550f01d4ab63c95f" }'
```

Devuelve `found`, `id`, `as_of` y `registration` (null cuando no se encuentra).

Cada registro incluye `id` (la clave), `registrant_key` (el mismo en todas las presentaciones de un negocio), `legal_name`, `dba_name`, `street_address`, `city`, `state`, `zip_code`, `country` (para un negocio ubicado fuera de EE. UU.), `activities[]` (la tabla de arriba), `activity_codes[]` (los códigos de FinCEN), `states_of_activity[]` (códigos de dos letras), `activity_scope` (la marca de FinCEN: `A` todos los estados y territorios, `B` todos los estados, `C` todos los territorios, `D` extranjero, o una combinación), `operates_abroad`, `branches`, `auth_sign_date`, `received_date`, `registration_number` (el número de registro MSB de FinCEN, de 14 dígitos), `registration_type` (p. ej. `Initial Registration`, `Renewal`), `document_url` (nuestra copia de la carta de registro de la presentación, un PDF) y `source_document_url` (el enlace de FinCEN a la carta cuando se leyó).

Los campos vacíos son `null`. Una fila es una presentación: un negocio que renovó su registro aparece una vez por presentación, y `registrant_key` las agrupa. FinCEN corta los nombres legales a 50 caracteres. El número y el tipo de registro vienen de la carta de registro de la presentación, que se lee una vez cuando la presentación aparece, así que una presentación recibida en los últimos días puede no tenerlos todavía. El enlace propio de FinCEN a una carta cambia con el tiempo; `document_url` no.

<Note>
  Un id que la lista no registra devuelve `found: false` con HTTP 200, no un
  error. Esa es también la respuesta para una presentación que salió de la lista.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>
