MVFC.Connectors.BrasilApi 4.0.0

dotnet add package MVFC.Connectors.BrasilApi --version 4.0.0
                    
NuGet\Install-Package MVFC.Connectors.BrasilApi -Version 4.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="MVFC.Connectors.BrasilApi" Version="4.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="MVFC.Connectors.BrasilApi" Version="4.0.0" />
                    
Directory.Packages.props
<PackageReference Include="MVFC.Connectors.BrasilApi" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add MVFC.Connectors.BrasilApi --version 4.0.0
                    
#r "nuget: MVFC.Connectors.BrasilApi, 4.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package MVFC.Connectors.BrasilApi@4.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=MVFC.Connectors.BrasilApi&version=4.0.0
                    
Install as a Cake Addin
#tool nuget:?package=MVFC.Connectors.BrasilApi&version=4.0.0
                    
Install as a Cake Tool

MVFC.Connectors.BrasilApi

Connector for the BrasilAPI public API, covering a wide range of Brazilian public data.

NuGet Downloads License CI Platform

English | Português


Features

  • Typed interfaces for each BrasilAPI endpoint
  • Covers address, financial, vehicle, geographic, and fiscal data
  • No authentication required
  • Fully integrated with MVFC.Connectors.Commons HTTP infrastructure

Installation

dotnet add package MVFC.Connectors.BrasilApi

Supported Endpoints

Interface Description
IBancoBrasilApi Brazilian bank list
ICepBrasilApi Address lookup by ZIP code (CEP)
ICnpjBrasilApi Company data lookup by CNPJ
ICambioBrasilApi Exchange rates
ICorretoraBrasilApi Stock brokers registered at CVM
ICptecBrasilApi Weather forecasts via CPTEC
IDddBrasilApi DDD area code information
IFeriadoBrasilApi Brazilian national holidays
IFipeBrasilApi FIPE vehicle pricing table
IIbgeBrasilApi IBGE cities and states data
IIsbnBrasilApi Book data by ISBN
INcmBrasilApi NCM fiscal classification
IPixParticipantesBrasilApi PIX participants list
IRegistroBrApi .br domain registration data
ITaxaBrasilApi Brazilian financial interest rates

Quick Start

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddBrasilApi();

var app = builder.Build();

Examples

// Lookup address by ZIP code
public class AddressService(ICepBrasilApi cepApi)
{
    public async Task<CepDto> GetAsync(string cep, CancellationToken ct)
    {
        return await cepApi.ObterAsync(cep, ct);
    }
}
// Lookup company by CNPJ
public class CompanyService(ICnpjBrasilApi cnpjApi)
{
    public async Task<CnpjDto> GetAsync(string cnpj, CancellationToken ct)
    {
        return await cnpjApi.ObterAsync(cnpj, ct);
    }
}
// List national holidays for a given year
public class HolidayService(IFeriadoBrasilApi feriadoApi)
{
    public async Task<IEnumerable<FeriadoDto>> GetAsync(int year, CancellationToken ct)
    {
        return await feriadoApi.ObterAsync(year, ct);
    }
}

Package Description
MVFC.Connectors.Commons Shared HTTP infrastructure
MVFC.Connectors.Geo Alternative address resolution via ViaCEP
MVFC.Connectors Repository overview

Contributing

Read CONTRIBUTING.md before opening issues or pull requests.


Security

If you discover a vulnerability, please refer to SECURITY.md.


License

Distributed under the license available in LICENSE.

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.0.0 92 4/7/2026
3.0.6 101 3/21/2026
3.0.5 102 3/17/2026
3.0.4 98 3/16/2026
2.1.4 100 2/19/2026
2.1.1 111 1/19/2026
2.1.0 105 1/19/2026
2.0.5 110 1/8/2026
2.0.4 111 1/7/2026
2.0.3 110 1/4/2026
2.0.2 109 1/3/2026
2.0.1 113 1/3/2026
1.2.0 239 11/16/2025
1.1.1 250 11/10/2025
1.1.0 215 11/10/2025
1.0.0 216 11/10/2025