JavaScript SDK Overview

​

JavaScript / TypeScript SDK

​

Features

• Full TypeScript type definitions for every request and response
• Automatic retry with exponential back-off on transient failures
• Structured error hierarchy with type guard helpers
• Multi-tenant support via businessId context
• Locale-aware responses (en-CA, fr-CA)
• ESM and CommonJS dual-module builds
• FormData-based file uploads and presigned S3 upload flow

​

Quick start

import { SmartbillsClient } from '@smartbills/sdk';

const client = new SmartbillsClient({
  accessToken: 'YOUR_API_KEY',
  businessId: 123,
  locale: 'en-CA',
});

// List recent expenses
const { data: expenses, pagination } = await client.expenses.listBusiness({
  limit: 25,
  page: 1,
});
console.log(`Found ${pagination.count} expenses`);

// Create an expense report
const report = await client.expenseReports.create({
  name: 'Q1 Travel Expenses',
});

// Upload a receipt
const formData = new FormData();
formData.append('files', receiptFile);
const uploaded = await client.expenses.uploadBusiness(formData);

​

Available services

​

Requirements

• Node.js 18 or later
• TypeScript 5.0 or later (optional but recommended)

​

Next steps

• Installation, install the package and configure your environment
• Authentication, set up credentials and multi-tenant context
• Expenses, full expense service reference
• Error Handling, understand the error hierarchy and write resilient code