TypeScript and Python SDK setup and usage

npm install @yoshi-ai/sdk
# or
pnpm add @yoshi-ai/sdk

pip install yoshi-sdk
# or
uv add yoshi-sdk

import Yoshi from "@yoshi-ai/sdk";

const yoshi = new Yoshi(); // reads YOSHI_API_KEY from env

const accounts = await yoshi.accounts.list();
const scores = await yoshi.scores.list();
const me = await yoshi.me.retrieve();
const summary = await yoshi.me.summary();

from yoshi import Yoshi

yoshi = Yoshi()  # reads YOSHI_API_KEY from env

accounts = yoshi.accounts.list()
scores = yoshi.scores.list()
me = yoshi.me.retrieve()
summary = yoshi.me.summary()

import Yoshi from "@yoshi-ai/sdk";

const yoshi = new Yoshi({
  apiKey: "yoshi_3xK9mP...",
  environment: "staging",
  maxRetries: 3,
  timeout: 60_000,
});

from yoshi import Yoshi

yoshi = Yoshi(
    api_key="yoshi_3xK9mP...",
    environment="staging",
    max_retries=3,
    timeout=60.0,
)

// Iterate over all transactions automatically
for await (const tx of yoshi.transactions.list({ limit: 100 })) {
  console.log(tx.merchant_name, tx.amount);
}

for tx in yoshi.transactions.list(limit=100):
    print(tx.merchant_name, tx.amount)

from yoshi import AsyncYoshi

yoshi = AsyncYoshi()

async for tx in yoshi.transactions.list(limit=100):
    print(tx.merchant_name, tx.amount)

const page = await yoshi.transactions.list({ limit: 50 });
console.log(page.data);
console.log(page.has_more);

page = yoshi.transactions.list(limit=50)
print(page.data)
print(page.has_more)

import Yoshi from "@yoshi-ai/sdk";

try {
  await yoshi.accounts.list();
} catch (err) {
  if (err instanceof Yoshi.AuthenticationError) {
    // 401 — invalid or revoked API key
  } else if (err instanceof Yoshi.RateLimitError) {
    // 429 — rate limited
    console.log("Retry after:", err.headers["retry-after"]);
  } else if (err instanceof Yoshi.NotFoundError) {
    // 404 — resource not found
  }
}

from yoshi import Yoshi, AuthenticationError, RateLimitError, NotFoundError

try:
    yoshi.accounts.list()
except AuthenticationError:
    # 401 — invalid or revoked API key
    pass
except RateLimitError as e:
    # 429 — rate limited
    print(f"Retry after: {e.response.headers['retry-after']}")
except NotFoundError:
    # 404 — resource not found
    pass