> ## 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.

# SEC EDGAR

> Form D, a notificação que toda empresa e fundo dos EUA apresenta ao captar capital privado: busque rodadas por emissor, pessoas, estado, setor, valor e data, e leia um filing completo.

Quando uma empresa ou um fundo dos EUA capta capital privado sob a
Regulation D, apresenta um Form D à Securities and Exchange Commission em até
quinze dias após a primeira venda: quem é o emissor, seus executivos e
diretores, o setor, quanto está captando, quanto já vendeu e para quantos
investidores. A rodada de uma startup e o fechamento de um fundo de venture
capital aparecem aqui igualmente, assinados pela empresa.

Todos os Form D apresentados desde 2008, organizados e prontos para consultar,
atualizados todos os dias. É isso que transforma uma busca em todas as
rodadas pelo nome de um executivo, ou todos os fundos de venture capital que
fecharam na Califórnia neste trimestre, em uma única chamada rápida.

<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 filings Form D

`POST /us/sec/form-d-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Busca os filings por qualquer combinação de texto, emissor, estado,
jurisdição, setor, tipo de fundo, tipo de formulário, datas e valor vendido.
Os mais recentes primeiro.

| Campo             | Tipo    | Notas                                                                                                                                                       |
| ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`           | string  | Opcional. Palavras a buscar no nome do emissor e nos nomes dos seus executivos, diretores e promotores. Todas as palavras devem coincidir; sem lematização. |
| `issuer_cik`      | string  | Opcional. O CIK do emissor no EDGAR, com ou sem zeros à esquerda: todos os filings de um emissor.                                                           |
| `state`           | string  | Opcional. Estado do endereço do emissor, duas letras, p. ex. `CA`.                                                                                          |
| `jurisdiction`    | string  | Opcional. Jurisdição de constituição como o formulário a escreve, p. ex. `DELAWARE`, `CAYMAN ISLANDS`.                                                      |
| `industry`        | string  | Opcional. Grupo de setor exatamente como o formulário o nomeia, p. ex. `Other Technology`, `Biotechnology`, `Pooled Investment Fund`.                       |
| `fund_type`       | enum    | Opcional. Para fundos: `venture_capital_fund`, `private_equity_fund`, `hedge_fund` ou `other_investment_fund`.                                              |
| `funds`           | enum    | Opcional. `include` (padrão), `exclude` para ver apenas empresas operacionais, `only` para ver apenas fundos. Por padrão `include`.                         |
| `form_type`       | enum    | Opcional. `D` para notificações novas, `D/A` para emendas.                                                                                                  |
| `filed_from`      | string  | Opcional. Limite inferior da data de apresentação (`yyyy-mm-dd`, inclusive).                                                                                |
| `filed_to`        | string  | Opcional. Limite superior da data de apresentação (`yyyy-mm-dd`, inclusive).                                                                                |
| `min_amount_sold` | number  | Opcional. Apenas filings que tenham vendido pelo menos este valor em dólares. Por padrão `0`.                                                               |
| `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/sec/form-d-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "databricks", "funds": "exclude" }'
```

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 `filings[]`, do mais recente ao mais antigo.

Cada filing traz `accession_number` (a chave), `form_type` (`D` novo, `D/A` emenda), `filed_on`, `file_number`, `issuer` (`{ cik, name, previous_names[], entity_type, incorporated: { span, year }, jurisdiction, address, phone }`), `co_issuers[]`, `industry_group` (como o formulário o nomeia: `Other Technology`, `Biotechnology`, `Pooled Investment Fund`, ...), `is_pooled_investment_fund`, `investment_fund_type` (`venture_capital_fund`, `private_equity_fund`, `hedge_fund`, `other_investment_fund` ou null), `revenue_range`, `federal_exemptions[]` (`06b`, `06c`, `3C`, ...), `is_amendment`, `previous_accession_number`, `first_sale_on`, `securities` (ações, dívida, opções, ...), `minimum_investment`, `offering` (`{ total_amount, total_amount_indefinite, amount_sold, remaining, note }`, em dólares), `investors` (`{ has_non_accredited, non_accredited_count, total_count }`), `sales_commissions`, `finders_fees`, `proceeds_to_related_persons`, `related_persons[]` (executivos, diretores e promotores com `name`, `relationships[]` e `address`), `related_person_names[]`, `recipients[]` (quem foi pago para vender), `signature` e `filing_url`.

Os montantes são números em dólares; um montante que o emissor marcou como indefinido é null com sua bandeira `_indefinite`. As datas são `yyyy-mm-dd`. Os campos vazios são `null`.

<Note>
  Todos os Form D desde 2008, empresas e fundos igualmente, atualizados
  diariamente a partir do EDGAR. Passe `funds: "exclude"` para ver apenas
  empresas operacionais, ou `funds: "only"` com `fund_type` para acompanhar
  os fechamentos de fundos de venture capital.
</Note>

## Um filing

`POST /us/sec/form-d-filing/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Resolve um Form D pelo seu número de acesso e retorna o registro completo.

| Campo              | Tipo   | Notas                                                                                                 |
| ------------------ | ------ | ----------------------------------------------------------------------------------------------------- |
| `accession_number` | string | **Obrigatório.** Número de acesso do EDGAR, p. ex. `0001587468-26-000001`, como retornado pela busca. |

```bash theme={"dark"}
curl https://api.croma.run/us/sec/form-d-filing/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "accession_number": "0001587468-26-000001" }'
```

Retorna `found`, `accession_number`, `as_of` e `filing` (null quando não encontrado).

Cada filing traz `accession_number` (a chave), `form_type` (`D` novo, `D/A` emenda), `filed_on`, `file_number`, `issuer` (`{ cik, name, previous_names[], entity_type, incorporated: { span, year }, jurisdiction, address, phone }`), `co_issuers[]`, `industry_group` (como o formulário o nomeia: `Other Technology`, `Biotechnology`, `Pooled Investment Fund`, ...), `is_pooled_investment_fund`, `investment_fund_type` (`venture_capital_fund`, `private_equity_fund`, `hedge_fund`, `other_investment_fund` ou null), `revenue_range`, `federal_exemptions[]` (`06b`, `06c`, `3C`, ...), `is_amendment`, `previous_accession_number`, `first_sale_on`, `securities` (ações, dívida, opções, ...), `minimum_investment`, `offering` (`{ total_amount, total_amount_indefinite, amount_sold, remaining, note }`, em dólares), `investors` (`{ has_non_accredited, non_accredited_count, total_count }`), `sales_commissions`, `finders_fees`, `proceeds_to_related_persons`, `related_persons[]` (executivos, diretores e promotores com `name`, `relationships[]` e `address`), `related_person_names[]`, `recipients[]` (quem foi pago para vender), `signature` e `filing_url`.

Os montantes são números em dólares; um montante que o emissor marcou como indefinido é null com sua bandeira `_indefinite`. As datas são `yyyy-mm-dd`. Os campos vazios são `null`.

<Note>
  Um número de acesso que o EDGAR não tem como Form D retorna `found: false`
  com HTTP 200, não um erro.
</Note>

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