> ## Documentation Index
> Fetch the complete documentation index at: https://developers.scrunch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account Status

> 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.



## OpenAPI

````yaml /api-reference/openapi.json get /account
openapi: 3.1.0
info:
  title: Scrunch Data API
  version: 0.1.0
servers:
  - url: https://api.scrunchai.com/v1
security: []
paths:
  /account:
    get:
      tags:
        - account
      summary: Get Account Status
      description: >-
        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.
      operationId: getAccountStatus
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountStatusModel'
        '400':
          description: >-
            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':
          description: The account tied to this API key no longer exists.
      security:
        - HTTPBearer:
            - query
components:
  schemas:
    AccountStatusModel:
      properties:
        organization_id:
          type: string
          title: Organization Id
          description: >-
            ULID identifier for the account (organization) the API key belongs
            to.
        organization_name:
          type: string
          title: Organization Name
          description: Display name of the account.
        plan:
          type: string
          title: Plan
          description: >-
            Machine-readable name of the account's subscription plan, for
            example `enterprise`. Empty when the account has no plan on file.
        plan_display_name:
          type: string
          title: Plan Display Name
          description: >-
            Human-readable name of the account's subscription plan, for example
            `Enterprise`. Empty when the account has no plan on file.
        status:
          type: string
          title: Status
          enum:
            - active
            - trialing
            - past_due
            - unpaid
            - paused
            - incomplete
            - canceled
            - incomplete_expired
            - subscription_not_found
            - unknown
          description: >-
            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:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Current Period Start
          description: >-
            Start of the current billing period, in UTC. `null` when no
            subscription is on file.
        current_period_end:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Current Period End
          description: >-
            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.
      type: object
      required:
        - organization_id
        - organization_name
        - plan
        - plan_display_name
        - status
        - current_period_start
        - current_period_end
      title: AccountStatusModel
      description: Subscription state of the account an API key belongs to.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

## Related topics

- [Get Pipeline Status](/api-reference/orchestration/get-pipeline-status.md)
- [Account API: Read the Subscription State of an API Key](/api-reference/account/overview.md)
- [Connect Claude, ChatGPT, or Cursor to Scrunch MCP](/mcp/setup.md)