Skip to main content
GET
/
accounts
cURL
curl --request GET \
  --url https://api.yoshi.ai/v1/accounts \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "accounts": [
      {
        "id": "<string>",
        "name": "<string>",
        "mask": "<string>",
        "type": "<string>",
        "subtype": "<string>",
        "connection_status": "<string>",
        "updated_at": "<string>",
        "balance_available": 123,
        "balance_current": 123,
        "balance_limit": 123,
        "as_of": "<string>",
        "institution_name": "<string>",
        "institution_logo": "<string>",
        "external_source": "<string>",
        "next_payment_due_date": "<string>",
        "interest_rate_percentage": 123,
        "hidden": true,
        "apy_percent_display": "<string>"
      }
    ]
  },
  "meta": {
    "request_id": "req_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}

Authorizations

Authorization
string
header
default:yoshi_test_...
required

A Yoshi API key from Settings → API Keys, or a Yoshi OAuth access token issued by Sign in with Yoshi.

Query Parameters

status
enum<string>
default:open
Available options:
open,
closed,
all
hidden
enum<string>
Available options:
true,
false

Response

200 - application/json

Accounts retrieved.

data
object
required
meta
object
required
Last modified on June 18, 2026