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

# Quickstart: fetch accounts and transactions

> Make your first Yoshi API call in under a minute. Fetch linked accounts and transactions in three steps with cursor-based pagination.

<Steps>
  <Step title="Get your API key">
    Follow the [Authentication](/authentication) guide to create a key.
  </Step>

  <Step title="Fetch your accounts">
    List all your linked financial accounts:

    ```bash theme={null}
    curl https://api.yoshi.ai/accounts \
      -H "Authorization: Bearer yoshi_YOUR_KEY"
    ```

    You'll get a response like:

    ```json theme={null}
    {
      "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"
      }
    }
    ```
  </Step>

  <Step title="Fetch your transactions">
    Get your recent transactions with pagination:

    ```bash theme={null}
    curl "https://api.yoshi.ai/transactions?limit=5" \
      -H "Authorization: Bearer yoshi_YOUR_KEY"
    ```
  </Step>
</Steps>

## Pagination

List endpoints support cursor-based pagination:

```bash theme={null}
# 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`:

```json theme={null}
{
  "data": [...],
  "has_more": true,
  "cursor": "eyJpZCI6Ii...",
  "count": 50,
  "meta": { ... }
}
```

When `has_more` is `false`, you've reached the last page.

## What's Next?

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/sdks#available-resources">
    Browse all available endpoints.
  </Card>

  <Card title="Rate Limits" icon="gauge-high" href="/rate-limits">
    Understand rate limiting before building integrations.
  </Card>
</CardGroup>