---
title: "Plan, monthly allowances, usage and rate limit"
method: GET
path: "/account"
tags: ["Account"]
---

# Plan, monthly allowances, usage and rate limit

`GET /account`

## Request

- Base URL: `https://adslighthouse.com/api/v1`
- URL: `https://adslighthouse.com/api/v1/account`
- Auth: HTTP bearer

Returns the plan, this month's scheduled and on-demand check usage against the allowance, project and keyword counts against the plan limits, and the API rate limit. Periods are UTC months. Use it before starting checks to confirm there is allowance left.

## Response `200`

Plan, monthly allowances, usage and rate limit

- object
  - `account_id` string, required
  - `role` 'owner' | 'admin' | 'member', required: Role of the person the credential acts for.
  - `credential` 'api_key' | 'oauth', required
  - `scopes` string[], required
  - `plan` object, required
    - `id` 'starter' | 'growth' | 'scale' | 'business' | 'enterprise', required
    - `name` string, required
    - `status` string, required: Subscription status, such as active or trialing.
    - `trial_ends_at` string, nullable, required
  - `period` string, required: Usage month, YYYY-MM in UTC. Allowances reset each month.
  - `scheduled_checks` object, required: Checks run by monitoring schedules this month.
    - `used` integer, required
    - `limit` integer, nullable, required: Null when the plan sets no fixed limit.
    - `remaining` integer, nullable, required
  - `realtime_checks` object, required: On-demand checks this month, including first project runs.
    - `used` integer, required
    - `limit` integer, nullable, required: Null when the plan sets no fixed limit.
    - `remaining` integer, nullable, required
  - `projects` object, required
    - `used` integer, required
    - `limit` integer, nullable, required
  - `keywords` object, required
    - `used` integer, required
    - `limit` integer, nullable, required
  - `rate_limit` object, required
    - `requests_per_minute` integer, required
    - `per` 'credential', required
  - `request_id` string

## Other responses

- `400`: Invalid parameters, cursor or body.
- `401`: Missing, invalid, expired or revoked credential.
- `403`: The credential lacks the write scope, the plan does not include the API, or the allowance is used up.
- `404`: Unknown project, keyword or run in this account.
- `409`: The idempotency key was already used for a different request.
- `429`: Rate limit reached. Retry after the Retry-After seconds.
- `503`: The requested service or file is temporarily unavailable.

---

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