---
title: "Account profile, balance, and spend — read-only, never bills"
method: GET
path: "/v1/account"
---

# Account profile, balance, and spend — read-only, never bills

`GET /v1/account`

## Request

- Base URL: `https://framefetch.net`
- URL: `https://framefetch.net/v1/account`
- Auth: HTTP bearer

Read-only snapshot of the calling account: email, signup date, current credit balance, spend today and this (UTC) month, the current LIMITS, and the account's auto-topup config. Unlike the extract family, this endpoint keeps working even at zero balance — it never charges.

## Response `200`

Account summary

- AccountSummary
  - `email` string, email
  - `created_at` string: ISO-8601 signup timestamp
  - `balance_micros` integer: Current credit balance, micro-USD
  - `spend_today_micros` integer
  - `spend_month_micros` integer: Spend so far in the current UTC calendar month
  - `limits` object: Current LIMITS (maxFrames, maxDurationSec, maxVideoBytes, maxTextOverlayFrames, maxBatchUrls, maxWatchSubscriptions)
  - `auto_topup` object
    - `enabled` boolean
    - `threshold_micros` integer, nullable
    - `amount_micros` integer, nullable

## Other responses

- `401`: Error envelope
- `429`: Error envelope

---

[API](https://skmtc.dev/framefetch/apis/framefetch-api.md) · [All operations](https://skmtc.dev/framefetch/apis/framefetch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/framefetch/apis/framefetch-api/revisions/5584e8eb9bf5?raw)