Skip to main content
1

Get your API key

Follow the Authentication guide to create a key.
2

Fetch your accounts

List all your linked financial accounts:
curl https://api.yoshi.ai/accounts \
  -H "Authorization: Bearer yoshi_YOUR_KEY"
You’ll get a response like:
{
  "data": {
    "accounts": [
      {
        "id": "acc_abc123",
        "name": "Chase Checking (...4521)",
        "type": "depository",
        "subtype": "checking",
        "balance_current": 4523.17,
        "institution_name": "Chase"
      }
    ]
  },
  "meta": {
    "request_id": "req_a1b2c3d4",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}
3

Fetch your transactions

Get your recent transactions with pagination:
curl "https://api.yoshi.ai/transactions?limit=5" \
  -H "Authorization: Bearer yoshi_YOUR_KEY"

Pagination

List endpoints support cursor-based pagination:
# First page
curl "https://api.yoshi.ai/transactions?limit=50" \
  -H "Authorization: Bearer yoshi_YOUR_KEY"

# Next page (use the cursor from the previous response)
curl "https://api.yoshi.ai/transactions?limit=50&cursor=eyJpZCI6Ii..." \
  -H "Authorization: Bearer yoshi_YOUR_KEY"
The response includes pagination fields at the top level alongside data:
{
  "data": [...],
  "has_more": true,
  "cursor": "eyJpZCI6Ii...",
  "count": 50,
  "meta": { ... }
}
When has_more is false, you’ve reached the last page.

What’s Next?

API Reference

Browse all available endpoints.

Rate Limits

Understand rate limiting before building integrations.
Last modified on April 16, 2026