---
title: "The presented key's account: credits, scopes and per-call spending limit"
method: GET
path: "/api/v1/account"
tags: ["Account"]
---

# The presented key's account: credits, scopes and per-call spending limit

`GET /api/v1/account`

## Request

- Base URL: `https://api.daystruct.ai`
- URL: `https://api.daystruct.ai/api/v1/account`
- Auth: HTTP bearer

Read-only; needs a key with the read scope and never returns the key. Check credits.available before a paid call, show the user the price first, and tell them what was spent afterwards. key.maxRequestPriceCredits null means the key has no per-call limit; each call's own maxPriceCredits still applies. Also available as the MCP tool get_daystruct_account. Charged responses report creditsRemaining. A low balance returns 402 insufficient_credits with requiredCredits, availableCredits and topUpUrl; a price above a limit returns 402 price_exceeds_limit with limitedBy (request or api_key).

## Response `200`

Account view

- object
  - `data` object
    - `accountId` string, required
    - `credits` object, required
      - `available` integer
      - `reserved` integer
      - `unit` 'credits'
    - `key` object, required
      - `id` string
      - `label` string
      - `displayPrefix` string
      - `scopes` string[]
      - `maxRequestPriceCredits` integer, nullable
      - `expiresAt` string, nullable
    - `canSpend` boolean, required
    - `topUpUrl` string, required
    - `keysUrl` string
    - `guidance` string
  - `meta` object

## Other responses

- `401`: api_key_required: no usable key was presented
- `403`: insufficient_scope: the key lacks read

---

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