Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maesn.com/llms.txt

Use this file to discover all available pages before exploring further.

The Maesn TypeScript SDK is currently in beta. The API surface may change between releases. We recommend pinning to a specific version in production.
The Maesn TypeScript SDK lets you interact with the unified API from your TypeScript or JavaScript application. It provides full type safety, built-in error handling, and supports all endpoints available in the API reference. The SDK is available on npm and is actively developed.

​
Installation

Install the SDK using your preferred package manager: 
npm add @maesn/typescript-sdk
The SDK is published as an ES Module (ESM) only. If your project uses CommonJS, import it with await import("@maesn/typescript-sdk").

​
Authentication

The SDK requires two API keys, which you can pass directly or load from environment variables:
KeyEnvironment variableDescription
apiKeyMAESN_API_KEYAuthenticates your application with the Maesn API
accountKeyMAESN_ACCOUNT_KEYIdentifies the end user’s connected target system
See the authentication guide for how to obtain these keys.

​
Example

The following example initializes the client and fetches a list of invoices for a connected end user: 
import { Maesn } from "@maesn/typescript-sdk";

const maesn = new Maesn({
  serverURL: "https://api.maesn.dev",
  security: {
    apiKey: process.env["MAESN_API_KEY"] ?? "",
    accountKey: process.env["MAESN_ACCOUNT_KEY"] ?? "",
  },
});

const result = await maesn.accounting.retrieveInvoices();

console.log(result);
Replace the environment variables with your actual API key and account key.
Last modified on March 30, 2026