> ## 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 da FinCEN

> Todo negócio de serviços monetários registrado na FinCEN: transmissores de dinheiro, descontadores de cheques, casas de câmbio e provedores de acesso pré-pago, nos EUA e no exterior. Busque por nome ou DBA, serviço, estado, onde opera, país e data de apresentação, e acompanhe as apresentações de um negócio.

Pela Bank Secrecy Act, um negócio de serviços monetários deve se registrar na
Financial Crimes Enforcement Network, a unidade de inteligência financeira do
Tesouro dos Estados Unidos, e renovar o registro a cada dois anos. Os bancos
consultam a lista antes de atender um. A FinCEN publica cada registro que tem,
inclusive os de negócios localizados fora dos EUA que atendem clientes
norte-americanos.

Cerca de 33.000 apresentações de uns 32.000 negócios, recebidas desde janeiro
de 2024: quem são, onde estão, os serviços para os quais se registraram, os
estados onde operam, se operam no exterior, suas filiais e quando o registro
foi assinado e recebido, e o número de registro MSB e a carta de registro de
cada apresentação. Atualizado quando a FinCEN atualiza a lista,
semanalmente.

| `activity`                             | Código FinCEN | Serviço                                       |
| -------------------------------------- | ------------- | --------------------------------------------- |
| `money_transmitter`                    | 409           | Transmissor de dinheiro                       |
| `check_casher`                         | 408           | Descontador de cheques                        |
| `currency_dealer_or_exchanger`         | 407           | Casa de câmbio                                |
| `dealer_in_foreign_exchange`           | 415           | Operador de câmbio                            |
| `issuer_of_money_orders`               | 404           | Emissor de ordens de pagamento (money orders) |
| `seller_of_money_orders`               | 405           | Vendedor de ordens de pagamento               |
| `redeemer_of_money_orders`             | 406           | Pagador de ordens de pagamento                |
| `issuer_of_travelers_checks`           | 401           | Emissor de cheques de viagem                  |
| `seller_of_travelers_checks`           | 402           | Vendedor de cheques de viagem                 |
| `redeemer_of_travelers_checks`         | 403           | Pagador de cheques de viagem                  |
| `seller_of_prepaid_access`             | 413           | Vendedor de acesso pré-pago                   |
| `provider_of_prepaid_access`           | 414           | Provedor de acesso pré-pago                   |
| `travelers_checks_sales_or_redemption` | 410           | Venda ou pagamento de cheques de viagem       |
| `money_orders_sales_or_redemption`     | 411           | Venda ou pagamento de ordens de pagamento     |
| `us_postal_service`                    | 412           | Serviço Postal dos EUA                        |
| `other`                                | 499           | Outro                                         |

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar registros

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

Busca em todos os registros por qualquer combinação de nome, serviço, lugar
e data de apresentação.

| Campo                 | Tipo    | Notas                                                                                                                          |
| --------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `query`               | string  | Opcional. Palavras do nome legal ou do DBA. Todas devem coincidir; sem stemming.                                               |
| `activity`            | enum    | Opcional. Um serviço registrado, pelo código da tabela acima, p. ex. `money_transmitter`.                                      |
| `state`               | string  | Opcional. O estado de duas letras do endereço do negócio, p. ex. `TX`.                                                         |
| `operates_in`         | string  | Opcional. Um estado ou território dos EUA de duas letras onde o negócio declarou operar, p. ex. `FL`.                          |
| `country`             | string  | Opcional. Para um negócio localizado fora dos EUA, seu país como a FinCEN o escreve, p. ex. `COLOMBIA`, `MEXICO`, `HONG KONG`. |
| `operates_abroad`     | boolean | Opcional. `true` para ver só os registros que declaram atividade fora dos EUA. Por padrão `false`.                             |
| `registrant_key`      | string  | Opcional. O `registrant_key` de um registro, para listar todas as apresentações desse negócio.                                 |
| `registration_number` | string  | Opcional. O número de registro MSB da FinCEN, de 14 dígitos, como aparece na carta de registro.                                |
| `from_date`           | string  | Opcional. Data mais antiga em que a FinCEN recebeu a apresentação, yyyy-mm-dd.                                                 |
| `to_date`             | string  | Opcional. Data mais recente em que a FinCEN recebeu a apresentação, yyyy-mm-dd.                                                |
| `page`                | integer | Opcional. Página, começa em 1. Por padrão `1`.                                                                                 |
| `per_page`            | integer | Opcional. Resultados por página, 1-50. Por padrão `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" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `registrations[]`, por nome legal.

Cada registro traz `id` (a chave), `registrant_key` (o mesmo em todas as apresentações de um negócio), `legal_name`, `dba_name`, `street_address`, `city`, `state`, `zip_code`, `country` (para um negócio localizado fora dos EUA), `activities[]` (a tabela acima), `activity_codes[]` (os códigos da FinCEN), `states_of_activity[]` (códigos de duas letras), `activity_scope` (a marca da FinCEN: `A` todos os estados e territórios, `B` todos os estados, `C` todos os territórios, `D` exterior, ou uma combinação), `operates_abroad`, `branches`, `auth_sign_date`, `received_date`, `registration_number` (o número de registro MSB da FinCEN, de 14 dígitos), `registration_type` (p. ex. `Initial Registration`, `Renewal`), `document_url` (nossa cópia da carta de registro da apresentação, um PDF) e `source_document_url` (o link da FinCEN para a carta quando foi lida).

Os campos vazios são `null`. Uma linha é uma apresentação: um negócio que renovou o registro aparece uma vez por apresentação, e `registrant_key` as agrupa. A FinCEN corta os nomes legais em 50 caracteres. O número e o tipo de registro vêm da carta de registro da apresentação, lida uma vez quando a apresentação aparece, então uma apresentação recebida nos últimos dias pode ainda não tê-los. O link próprio da FinCEN para uma carta muda com o tempo; `document_url` não.

<Warning>
  Nas palavras da 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." A lista reflete só o que cada
  registrante declarou à FinCEN, nem todo negócio registrado aparece, e o
  registro não é uma licença: as licenças dos negócios de serviços monetários
  são concedidas pelos estados.
</Warning>

## Um registro

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

Resolve um registro pelo seu id e retorna o registro completo.

| Campo | Tipo   | Notas                                                        |
| ----- | ------ | ------------------------------------------------------------ |
| `id`  | string | **Obrigatório.** O id do registro como retornado pela busca. |

```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" }'
```

Retorna `found`, `id`, `as_of` e `registration` (null quando não encontrado).

Cada registro traz `id` (a chave), `registrant_key` (o mesmo em todas as apresentações de um negócio), `legal_name`, `dba_name`, `street_address`, `city`, `state`, `zip_code`, `country` (para um negócio localizado fora dos EUA), `activities[]` (a tabela acima), `activity_codes[]` (os códigos da FinCEN), `states_of_activity[]` (códigos de duas letras), `activity_scope` (a marca da FinCEN: `A` todos os estados e territórios, `B` todos os estados, `C` todos os territórios, `D` exterior, ou uma combinação), `operates_abroad`, `branches`, `auth_sign_date`, `received_date`, `registration_number` (o número de registro MSB da FinCEN, de 14 dígitos), `registration_type` (p. ex. `Initial Registration`, `Renewal`), `document_url` (nossa cópia da carta de registro da apresentação, um PDF) e `source_document_url` (o link da FinCEN para a carta quando foi lida).

Os campos vazios são `null`. Uma linha é uma apresentação: um negócio que renovou o registro aparece uma vez por apresentação, e `registrant_key` as agrupa. A FinCEN corta os nomes legais em 50 caracteres. O número e o tipo de registro vêm da carta de registro da apresentação, lida uma vez quando a apresentação aparece, então uma apresentação recebida nos últimos dias pode ainda não tê-los. O link próprio da FinCEN para uma carta muda com o tempo; `document_url` não.

<Note>
  Um id que a lista não registra retorna `found: false` com HTTP 200, não um
  erro. Essa é também a resposta para uma apresentação que saiu da lista.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>
