Skip to main content

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.

​
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. 
curl -X GET https://simplehost.dev/api/v1/account \
  -H "Authorization: Bearer sh_live_your_key_here"

​
Response

{
  "email": "you@example.com",
  "plan": "free",
  "handle": null,
  "usage": {
    "sites": {
      "used": 12,
      "limit": 500
    },
    "storage": {
      "used": "1.2 GB",
      "usedBytes": 1288490188,
      "limit": "10 GB",
      "limitBytes": 10737418240
    }
  },
  "limits": {
    "maxFileSize": "250 MB",
    "maxFileSizeBytes": 262144000,
    "maxSites": 500,
    "maxStorage": "10 GB"
  },
  "createdAt": "2026-01-15T10:30:00.000Z"
}

​
Response Fields

​
email
string
The email address associated with your account.
​
plan
string
Your current plan: "free" or "hobby".
​
handle
string | null
Your vanity handle (e.g., "yourname" for yourname.simplehost.dev), or null if not set.
​
usage
object
Current usage across sites and storage. Each sub-object has used and limit fields.
​
limits
object
Your plan’s limits — max file size, max sites, and max storage.
​
createdAt
string
ISO 8601 timestamp of when your account was created.
On the Hobby plan, usage.sites.limit returns "unlimited" instead of a number.

​
Errors

CodeStatusDescription
UNAUTHORIZED401Missing or invalid API key