---
title: "Account summary for the calling API key"
method: GET
path: "/v1/account"
tags: ["Account summary"]
---

# Account summary for the calling API key

`GET /v1/account`

## Request

- Base URL: `https://api.vatnode.dev`
- URL: `https://api.vatnode.dev/v1/account`
- Auth: HTTP bearer

Plan entitlements, quota consumption, monitoring usage and billing
state for the account the key belongs to. Read-only and local: it never
calls VIES, never contacts the payment provider and never spends
quota, so an integration can poll it cheaply and use it as its
connection test – an invalid or revoked key returns `401`.

Test keys are accepted, so a customer can wire up an integration
against the sandbox before switching to a live key.

Carries no personal data: an API key identifies an account, not a
person.

## Response `200`

Entitlements and consumption for the account.

- object
  - `key` object, required
    - `id` string, uuid, required
    - `label` string, required: Human-readable key label set in the dashboard.
    - `environment` 'live' | 'test', required
  - `plan` object, required
    - `id` string, required
    - `name` string, required
    - `monthlyQuota` integer, required: Included validations per month. `-1` = unlimited.
    - `subscriptionsLimit` integer, required: Monitored VAT IDs allowed. `-1` = unlimited, `0` = not available on this plan.
    - `webhooksLimit` integer, required: Webhook endpoints allowed. `-1` = unlimited, `0` = not available on this plan.
  - `usage` object, required
    - `used` integer, required: Validations spent in the current quota window.
    - `limit` integer, required: Same as `plan.monthlyQuota`, repeated so a client needs one field.
    - `remaining` integer, required: Validations left inside the included quota, floored at 0. `-1` on an unlimited plan. Checks continue past 0 where the plan allows overage – this is not a hard stop.
    - `overage` integer, required: Validations beyond the included quota in this window.
    - `resetAt` string, date-time, nullable, required: When the quota window rolls over, anchored to the signup day-of-month.
  - `monitoring` object, required: Current consumption against the plan’s monitoring limits, counted the same way those limits are enforced on create.
    - `subscriptions` UsageAgainstLimit, required
      - `used` integer, required: How many the account currently has.
      - `limit` integer, required: How many the plan allows. `-1` = unlimited, `0` = not available on this plan.
    - `webhooks` UsageAgainstLimit, required
      - `used` integer, required: How many the account currently has.
      - `limit` integer, required: How many the plan allows. `-1` = unlimited, `0` = not available on this plan.
  - `billing` object, required
    - `status` 'active' | 'past_due' | 'canceling' | 'canceled' | 'null', nullable, required: Subscription state. `null` on a free account.
    - `interval` 'month' | 'year' | 'null', nullable, required: Billing cadence. `null` when there is no paid subscription.
    - `currentPeriodEnd` string, date-time, nullable, required: End of the paid period. `null` on a free account.
    - `nextChargeAt` string, date-time, nullable, required: When the subscription renews. `null` unless the status is `active` — a cancelling subscription runs to the end of the period and is not charged again.

## Other responses

- `401`: Missing or invalid API key.

---

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