Skip to main content

​
SDKs

Narrative SDK provides official client libraries for JavaScript and Python so you can integrate faster than working from raw HTTP calls alone.
Use these SDKs when you want typed request helpers, consistent authentication handling, and a faster path from proof of concept to production integration.

​
Available SDKs

https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/frontend-shell.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=13c676d362a2a3a7a60bfa0fae245ad6

JavaScript SDK

Browser and server-side helpers for authentication, capability calls, and embedded runtime bootstrapping.
https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/server.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=4a767cfdcb6585e74810e5c286495132

Python SDK

Backend-friendly client for authentication, token exchange, and platform capability workflows.

​
Installation

npm
npm install @narrativebanking/sdk
pnpm
pnpm add @narrativebanking/sdk
yarn
yarn add @narrativebanking/sdk

​
Quick examples

import { NarrativeClient } from "@narrativebanking/sdk";

const client = new NarrativeClient({
  apiBaseUrl: process.env.NSDK_API_BASE_URL!,
  accessToken: process.env.NSDK_ACCESS_TOKEN!,
});

const me = await client.auth.me();
const metrics = await client.money.metrics({ asOfDate: "2026-03-16" });

​
What the SDKs cover

AreaJavaScript SDKPython SDK
Authentication helpersYesYes
Access-token bearer authYesYes
Refresh flow supportYesYes
Coach, Money, and Growth clientsYesYes
Embedded runtime bootstrappingYesBackend token support

​
When to use SDKs vs direct integration

The SDKs reduce boilerplate around auth, base URL configuration, and capability organization.
If your environment already has a standardized HTTP abstraction, you can still integrate using your own client patterns.
Many teams use the hosted loader for embedded UI and use SDKs mainly for backend or service-to-service workflows.

​
Next steps