# Account

For AI agents: this is the Markdown version of https://docs.fashiolabs.com/account.html. The index of all Fashio API docs is at https://docs.fashiolabs.com/llms.txt, and the complete reference in one file is at https://docs.fashiolabs.com/llms-full.txt.

One call to check who a key belongs to, what plan it's on, and how many credits are left — useful for showing your own users their Fashio usage without sending them to the dashboard.

`GET /v1/account` · no body

## Request

**cURL**

```bash
curl https://api.fashiolabs.com/v1/account \
  -H "Authorization: Bearer fio_live_YOUR_KEY"
```

**Node.js**

```javascript
const res = await fetch("https://api.fashiolabs.com/v1/account", {
  headers: { Authorization: "Bearer " + process.env.FASHIO_API_KEY },
});
const account = await res.json();
```

**Python**

```python
import os, requests

res = requests.get(
    "https://api.fashiolabs.com/v1/account",
    headers={"Authorization": f"Bearer {os.environ['FASHIO_API_KEY']}"},
)
account = res.json()
```

## Response

**200**

```json
{
  "success": true,
  "email": "brand@example.com",
  "diamondBalance": 214,
  "plan": {
    "isPremium": true,
    "status": "active",
    "planProductId": "growth_yearly",
    "provider": "revenuecat",
    "cancelAtPeriodEnd": false,
    "renewsAt": "2026-09-27T00:00:00.000Z"
  }
}
```

## Fields

| Field | Description |
| --- | --- |
| `email` | The account's email, or `null` if unavailable. |
| `diamondBalance` | Current credit balance — the same number [Pricing & Credits](https://docs.fashiolabs.com/pricing.md) is quoted against. |
| `plan.isPremium` | Whether an active paid plan is on the account. |
| `plan.status` | One of `active`, `will_expire`, `paused`, `billing_issue`, `expired`, `refunded`, `none`. |
| `plan.planProductId` | The subscribed product id, or `null` with no active plan. |
| `plan.cancelAtPeriodEnd` | `true` if the plan is cancelled but still active until `renewsAt`. |
| `plan.renewsAt` | ISO 8601 timestamp of the next renewal/expiry, or `null` with no active plan. |

> There's no separate API quota — `diamondBalance` is the exact same balance shown in the app and dashboard. Top up or upgrade from [dash.fashiolabs.com](https://dash.fashiolabs.com/).

---

Source: https://docs.fashiolabs.com/account.html · OpenAPI spec: https://docs.fashiolabs.com/openapi.yaml · Docs index: https://docs.fashiolabs.com/llms.txt
