---
title: "Plan limits, subscription dates, meters and forecast"
method: GET
path: "/account/overview"
tags: ["Account"]
---

# Plan limits, subscription dates, meters and forecast

`GET /account/overview`

## Request

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

Read-only overview of the account: plan and its limits, subscription status, trial allowance and end, current billing period end and any scheduled cancellation, this month's scheduled and on-demand check meters (a check is one keyword × location × device × source search), and the forecast of scheduled checks at the current configuration. Usage months are UTC. Plan changes, checkout and payment methods are only available to the owner in the app.

## Response `200`

Plan limits, subscription dates, meters and forecast

- object
  - `account_id` string, required
  - `label` string, required
  - `your_role` 'owner' | 'admin' | 'member', required
  - `can_change_plan_in_app` boolean, required: Only the owner can change the plan, in Settings > Billing. Not available through the API.
  - `plan` object, required
    - `id` 'starter' | 'growth' | 'scale' | 'business' | 'enterprise', required
    - `name` string, required
    - `monthly_price_usd` number, nullable, required
    - `limits` object, required
      - `projects` integer, nullable, required
      - `keywords` integer, nullable, required
      - `locations_per_project` integer, nullable, required
      - `scheduled_checks_per_month` integer, nullable, required
      - `realtime_checks_per_month` integer, nullable, required
      - `max_runs_per_day` integer, nullable, required
    - `includes` object, required
      - `rest_api` boolean, required
      - `mcp` boolean, required
      - `shopping` boolean, required
  - `status` 'preview' | 'trialing' | 'active' | 'past_due' | 'canceled' | 'unpaid' | 'paused' | 'incomplete' | 'incomplete_expired', required: Subscription status.
  - `trial` object, nullable, required: Present while trialing: the trial allowance caps checks until the trial ends.
    - `ends_at` string, nullable, required
    - `scheduled_checks` object, required
      - `used` integer, required
      - `limit` integer, nullable, required
    - `realtime_checks` object, required
      - `used` integer, required
      - `limit` integer, nullable, required
  - `billing_period` object, required
    - `current_period_end` string, nullable, required
    - `cancel_scheduled` boolean, required
    - `access_ends_at` string, nullable, required: When a scheduled cancellation takes effect; null when none is scheduled.
  - `usage_period` string, required: Usage month, YYYY-MM in UTC. Allowances reset each month.
  - `scheduled_checks` object, required
    - `used` integer, required
    - `limit` integer, nullable, required: Null when the plan sets no fixed limit.
    - `remaining` integer, nullable, required: What can still be reserved, including any trial allowance. Null when unlimited.
  - `realtime_checks` object, required
    - `used` integer, required
    - `limit` integer, nullable, required: Null when the plan sets no fixed limit.
    - `remaining` integer, nullable, required: What can still be reserved, including any trial allowance. Null when unlimited.
  - `forecast` object, required: The same forecast the app uses before accepting coverage changes.
    - `daily_scheduled_checks` integer, required: Scheduled checks per day at the current configuration: keywords × locations × devices × sources × runs per day.
    - `full_month_scheduled_checks` integer, required: daily_scheduled_checks × 31.
    - `projected_scheduled_checks` integer, required: Used this month plus the runs still due before the month ends (UTC).
    - `fits_plan` boolean, required: True when both the full-month demand and the projection fit the monthly allowance.
  - `projects` object, required
    - `used` integer, required
    - `limit` integer, nullable, required
  - `keywords` object, required
    - `used` integer, required
    - `limit` integer, nullable, required
    - `activated_this_month` integer, required: Distinct keywords activated this month; deleting keywords does not lower it.
  - `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)