Skip to main content

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/sdk

React Hooks

React Query hooks for data fetching, @smartbills/react-hooks

React Native SDK

Native receipt display and mobile components, @smartbills/react-native

.NET SDK

C# SDK for .NET applications, Smartbills.SDK

Python SDK

Python SDK for server-side applications, smartbills

Installation

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