---
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
- TypeScript: <https://skmtc.dev/scrunch/apis/scrunch-data-api/docs/account/get.ts> (a function with typed inputs; its response is checked against the schema)

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 Scrunch 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: ULID identifier for the account (organization) the API key belongs to.
  - `organization_name` string, required: Display name of the account.
  - `plan` string, required: Machine-readable name of the account's subscription plan, for example `enterprise`. Empty when the account has no plan on file.
  - `plan_display_name` string, required: Human-readable name of the account's subscription plan, for example `Enterprise`. Empty when the account has no plan on file.
  - `status` 'active' | 'trialing' | 'past_due' | 'unpaid' | 'paused' | 'incomplete' | 'canceled' | 'incomplete_expired' | 'subscription_not_found' | 'unknown', required: Subscription state of the account. Values `active`, `trialing`, `past_due`, `unpaid`, `paused`, `incomplete`, `canceled`, and `incomplete_expired` mirror Stripe's subscription statuses. `subscription_not_found` means Scrunch holds no Stripe subscription record for the account (normal for manually invoiced accounts) and is not a sign the account lapsed. `unknown` means Scrunch cannot vouch for the current state; keep your current behavior rather than treating it as a lapse.
  - `current_period_start` string, date-time, nullable, required: Start of the current billing period, in UTC. `null` when no subscription is on file.
  - `current_period_end` string, date-time, nullable, required: End of the current billing period, in UTC. While `status` is `trialing`, this is also the date the trial ends. `null` when no subscription is on file.

## Other responses

- `400`: The credential is not scoped to a single account. Returned when the caller authenticates with a user session (JWT) instead of an API key, since a user may belong to several organizations.
- `404`: The account tied to this API key no longer exists.

## Changes

- **2026-11-03** `e37811b6bc07`: 1 info
  - endpoint added

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

---

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