---
title: "Plan, renders and limits"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Plan, renders and limits

`GET /v1/account`

## Request

- Base URL: `https://api-eu.dynamicdocumentapi.com`
- URL: `https://api-eu.dynamicdocumentapi.com/v1/account`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Response `200`

- Account
  - `cycle` object, required
    - `end` string, date-time
    - `start` string, date-time
  - `limits` object, required: Effective plan limits ([plans and limits](https://dynamicdocumentapi.com/docs/plans-and-limits)).
    - `bulk_concurrency` integer
    - `max_pages` integer
    - `max_payload_mb` integer
    - `rate_limit_rps` integer
    - `sync_concurrency` integer
    - `sync_timeout_s` integer
  - `plan` object, required
    - `code` string
    - `interval` 'month' | 'year'
  - `regions` string[], required: Regions this workspace may render in.
  - `renders` object, required: Billed renders in the current cycle (whole numbers).
    - `included` integer: Plan allowance.
    - `prepaid_remaining` integer: Left in render packs and auto top-ups.
    - `remaining_included` integer
    - `spend_cap_cents` integer: Monthly top-up limit: total cycle spend (plan price + auto top-ups) in euro cents, excluding VAT. 0 = auto top-ups off.
    - `used` integer: Of the allowance.
  - `workspace` object, required
    - `id` string
    - `name` string

## Other responses

- `401`: Missing, invalid, expired or revoked credentials.
- `403`: Insufficient scope, IP not allowed, workspace suspended or scheduled for deletion, or email not verified.
- `429`: Rate limited (`Retry-After`).
- `503`: Control plane unavailable.

---

[API](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api.md) · [All operations](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api/revisions/0f14bc0000f4?raw)