nfrax logonfrax

Infrastructure that just works. Ship products, not boilerplate.

Frameworks

  • svc-infra
  • ai-infra
  • fin-infra
  • robo-infra

Resources

  • Getting Started
  • What's New
  • Contributing

Community

  • GitHub

© 2026 nfrax. All rights reserved.

nfrax logonfrax
Start HereWhat's New
GitHub
fin-infra / API Reference

IRSProvider

from fin_infra.providers.tax import IRSProvider
View source
fin_infra.providers.tax
Extends:TaxProvider

IRS e-Services provider (v2 - not yet implemented). **Registration Required**: - EFIN (Electronic Filing Identification Number) - TCC (Transmitter Control Code) - PKI certificates (cert + key files) - IP whitelist approval from IRS - 6-8 weeks processing time **Environment Variables**: - IRS_EFIN: Electronic Filing ID - IRS_TCC: Transmitter Control Code - IRS_CERT_PATH: Path to public certificate (.pem) - IRS_KEY_PATH: Path to private key (.pem) - IRS_BASE_URL: API endpoint (default: https://la.www4.irs.gov) **Supported Forms**: - W-2: Wage and Tax Statement - 1099-INT: Interest Income - 1099-DIV: Dividends - 1099-MISC: Miscellaneous Income - 1099-B: Broker Transactions (limited) **Not Supported**: - Crypto tax calculations (use TaxBit provider) - Real-time document retrieval (IRS has delays)

Example

>>> provider = IRSProvider( ... efin=os.getenv("IRS_EFIN"), ... tcc=os.getenv("IRS_TCC"), ... cert_path=os.getenv("IRS_CERT_PATH"), ... key_path=os.getenv("IRS_KEY_PATH") ... ) >>> # Raises NotImplementedError until v2 implementation

Constructor
IRSProvider(efin: str | None = None, tcc: str | None = None, cert_path: str | None = None, key_path: str | None = None, base_url: str = 'https://la.www4.irs.gov', kwargs = {})
ParameterTypeDefaultDescription
efinstr|NoneNoneElectronic Filing ID (required)
tccstr|NoneNoneTransmitter Control Code (required)
cert_pathstr|NoneNonePath to public certificate .pem file (required)
key_pathstr|NoneNonePath to private key .pem file (required)
base_urlstr'https://la.www4.irs.gov'IRS API endpoint (default: production)
kwargsAny{}—

Methods

On This Page

Constructorcalculate_crypto_gainscalculate_tax_liabilitydownload_documentget_tax_documentget_tax_documentsget_tax_forms