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

# Yoshi API introduction and key concepts

> Get started with the Yoshi API to access financial accounts, transactions, investments, and scores. Includes base URL, auth, and pagination.

The Yoshi API gives you read access to your linked financial accounts,
transactions, investment holdings, financial scores, and more.

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Get your API key and make your first request.
  </Card>

  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Fetch your accounts and transactions in 3 steps.
  </Card>

  <Card title="Rate Limits" icon="gauge-high" href="/rate-limits">
    Understand rate limiting and best practices.
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/errors">
    Error codes, response format, and troubleshooting.
  </Card>
</CardGroup>

## Base URL

All API requests use:

```
https://api.yoshi.ai/v1
```

## Key Concepts

* **API Keys** — Authenticate with `Authorization: Bearer yoshi_...`
* **Rate Limits** — 100 requests per minute per key
* **Pagination** — Cursor-based for list endpoints
* **Response Envelope** — All responses wrapped in `{ data, meta }` or `{ error, meta }`. Paginated endpoints include top-level `has_more`, `cursor`, and `count` fields
* **Request IDs** — Every response includes a unique `request_id` for debugging