> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yoshi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Chronological release notes for the Yoshi API, including new endpoints, breaking changes, deprecations, bug fixes, and SDK version updates.

## 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

***

<Info>
  Future updates will be listed here in reverse chronological order. Breaking changes will include migration guidance.
</Info>