> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simplehost.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Account

> Get your account info, plan, and usage stats

## Get Account Info

Returns the authenticated user's account details, current plan, usage statistics, and plan limits.

```
GET /api/v1/account
```

### Authentication

Requires an API key in the `Authorization` header.

```bash theme={null}
curl -X GET https://simplehost.dev/api/v1/account \
  -H "Authorization: Bearer sh_live_your_key_here"
```

### Response

```json theme={null}
{
  "email": "you@example.com",
  "plan": "free",
  "handle": null,
  "usage": {
    "sites": {
      "used": 12,
      "limit": 500
    },
    "storage": {
      "used": "84 MB",
      "usedBytes": 88080384,
      "limit": "200 MB",
      "limitBytes": 209715200
    }
  },
  "limits": {
    "maxFileSize": "200 MB",
    "maxFileSizeBytes": 209715200,
    "maxSites": 500,
    "maxStorage": "200 MB"
  },
  "createdAt": "2026-01-15T10:30:00.000Z"
}
```

### Response Fields

<ResponseField name="email" type="string">
  The email address associated with your account.
</ResponseField>

<ResponseField name="plan" type="string">
  Your current plan: `"free"` or `"hobby"`.
</ResponseField>

<ResponseField name="handle" type="string | null">
  Your vanity handle (e.g., `"yourname"` for `yourname.simplehost.dev`), or `null` if not set.
</ResponseField>

<ResponseField name="usage" type="object">
  Current usage across sites and storage. Each sub-object has `used` and `limit` fields.
</ResponseField>

<ResponseField name="limits" type="object">
  Your plan's limits — max file size, max sites, and max storage.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when your account was created.
</ResponseField>

<Note>
  On the Hobby plan, `usage.sites.limit` returns `"unlimited"` instead of a number.
</Note>

### Errors

| Code           | Status | Description                |
| -------------- | ------ | -------------------------- |
| `UNAUTHORIZED` | 401    | Missing or invalid API key |