Available SDKs
Smartbills provides official SDKs for JavaScript, TypeScript, React, React Native, Python, and .NET to help you integrate expense management, digital receipts, and financial automation into your applications.JavaScript SDK
Core SDK for Node.js and browser applications,
@smartbills/sdkReact Hooks
React Query hooks for data fetching,
@smartbills/react-hooksReact Native SDK
Native receipt display and mobile components,
@smartbills/react-native.NET SDK
C# SDK for .NET applications,
Smartbills.SDKPython SDK
Python SDK for server-side applications,
smartbillsInstallation
Quick Start
All SDKs use the same authentication pattern with access tokens:SDK Architecture
The JavaScript SDK (@smartbills/sdk) serves as the core client. The React Hooks SDK and React Native SDK build on top of it, adding React-specific data fetching and native mobile components. The .NET and Python SDKs are standalone clients that communicate directly with the Smartbills API.
Authentication
All SDKs use OAuth 2.0 bearer tokens:Features
Common Features
- Type Safety: Full TypeScript / C# / Python type definitions
- Error Handling: Typed error classes with guards (
isNotFoundError,isValidationError, etc.) - Pagination: Built-in support for paginated list endpoints
- Retry Logic: Automatic retry for transient failures with configurable backoff
- Rate Limiting: Automatic rate limit handling
Feature Matrix
The .NET SDK currently focuses on invoicing, file management, and billing. Additional service clients (expenses, vendors, reports) are planned for future releases.
Version Compatibility
Choosing an SDK
Support
GitHub
Report bugs and request features
Community
Get help from the community