Skip to main content

April 2026

v1.0 — Initial public API release

The Yoshi consumer API is now publicly available. This release includes: Core data endpoints:
  • GET /accounts — List linked financial accounts with balances
  • GET /accounts/{id}/balances — Historical daily balance series
  • GET /transactions — List transactions with cursor-based pagination
  • GET /scores — Financial health scores (Yoshi, Recovery, Capacity, Baseline)
  • GET /goals — Financial goals and progress
  • GET /recurring — Recurring streams (subscriptions, bills, income)
  • GET /investments — Investment holdings grouped by asset class
  • GET /income — Income analysis and distribution
  • GET /me — User profile
  • GET /me/summary — Comprehensive financial overview
Card benefits:
  • GET /benefits/summary — Active card benefit periods with usage
  • GET /benefits/expiring — Benefits expiring within a configurable window
Paper trading:
  • POST /paper-trading/accounts — Create virtual trading accounts
  • GET /paper-trading/accounts — List paper trading accounts
  • POST /paper-trading/accounts/{id}/trades — Place simulated trades
  • GET /paper-trading/accounts/{id}/holdings — Current positions
  • GET /paper-trading/accounts/{id}/trades — Trade history
Actions & approvals:
  • POST /actions — Create action proposals
  • GET /actions — List actions
  • GET /actions/{id} — Retrieve single action
  • GET /approvals/{threadId} — Check approval status
Webhooks:
  • Real-time event delivery for transaction, balance, account, investment, score, income, and recurring changes
  • HMAC-SHA256 signature verification
  • Self-service portal for endpoint management
SDKs:
  • TypeScript (@yoshi-ai/sdk)
  • Python (yoshi-sdk)
  • Go (github.com/yoshi-ai-dev/yoshi-go)
CLI:
  • yoshi CLI via Homebrew or Go install
Infrastructure:
  • Unkey-based API key authentication with yoshi_ prefix
  • Cursor-based pagination
  • RFC 9457-inspired error envelope
  • 100 requests/minute rate limiting per key
  • Idempotency-Key support on mutating endpoints

Future updates will be listed here in reverse chronological order. Breaking changes will include migration guidance.
Last modified on April 30, 2026