# `Brasilapi.Cnpj.API`
[🔗](https://github.com/stlucasgarcia/brasilapi-ex/blob/main/lib/brasilapi/cnpj/api.ex#L1)

Client for BrasilAPI CNPJ endpoints.

Provides functions to fetch information about Brazilian companies by CNPJ.

# `get_by_cnpj`

```elixir
@spec get_by_cnpj(String.t() | integer()) ::
  {:ok, Brasilapi.Cnpj.Company.t()} | {:error, map()}
```

Fetches information about a company by its CNPJ.

## Parameters

  * `cnpj` - The CNPJ number (string or integer)

## Examples

    iex> Brasilapi.Cnpj.API.get_by_cnpj("11000000000197")
    {:ok, %Brasilapi.Cnpj.Company{cnpj: "11000000000197", razao_social: "ACME INC"}}

    iex> Brasilapi.Cnpj.API.get_by_cnpj("00000000000000")
    {:error, %{status: 404, message: "Not found"}}

## API Reference
  https://brasilapi.com.br/docs#tag/CNPJ/paths/~1cnpj~1v1~1%7Bcnpj%7D/get

---

*Consult [api-reference.md](api-reference.md) for complete listing*