---
title: "Get Account Status"
method: GET
path: "/account"
tags: ["account"]
---

# Get Account Status

`GET /account`

## Request

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

Get the subscription state of the account this API key belongs to. Use `status` to tell a trial from a paid or churned account: `trialing` means the account is in its trial, and `current_period_end` is the date that trial ends. `subscription_not_found` means the account has no Stripe subscription on file, which is normal for manually invoiced accounts and is not a sign that the account lapsed. `unknown` means we cannot vouch for the account's current state, either because its billing record is no longer being kept up to date or because it is in a state this endpoint does not publish yet; keep your current behavior rather than treating it as a lapse.

## Response `200`

Successful Response

- AccountStatusModel: Subscription state of the account an API key belongs to.
  - `organization_id` string, required
  - `organization_name` string, required
  - `plan` string, required
  - `plan_display_name` string, required
  - `status` union, required
    - 'active' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'past_due' | 'paused' | 'trialing' | 'unpaid'
    - 'subscription_not_found' | 'unknown'
  - `current_period_start` string, date-time, nullable, required
  - `current_period_end` string, date-time, nullable, required

## Changes

- **2026-09-23** `89d09be4a43e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scrunchai/apis/scrunch-data-api/changes/account/get.md)

---

[API](https://skmtc.dev/scrunchai/apis/scrunch-data-api.md) - [All operations](https://skmtc.dev/scrunchai/apis/scrunch-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrunchai/apis/scrunch-data-api/revisions/de4fc679600a?raw)
