---
title: "Get your company's subscription"
method: GET
path: "/subscriptions/company"
tags: ["Subscriptions"]
---

# Get your company's subscription

`GET /subscriptions/company`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/subscriptions/company`
- Auth: HTTP bearer

## Response `200`

- CompanySubscriptionInfo: Response of GET /subscriptions/company.
  - `subscription` CompanySubscription, required
    - `id` string, uuid, required
    - `companyId` string, uuid, required
    - `planId` string, uuid, required
    - `planPriceId` string, uuid, nullable
    - `stripeSubscriptionId` string, nullable: Company admins only — omitted for members.
    - `stripeCustomerId` string, nullable: Company admins only — omitted for members.
    - `stripeScheduleId` string, nullable: Company admins only — omitted for members.
    - `hasStripeSubscription` boolean: Whether a live Stripe subscription backs this row (false for a self-serve trial without card).
    - `hasStripeCustomer` boolean: Whether the company has a Stripe customer.
    - `status` 'trialing' | 'active' | 'past_due' | 'canceled', required
    - `currentPeriodStart` string, date-time
    - `currentPeriodEnd` string, date-time
    - `activeAgentsPurchased` integer, required
    - `pendingActiveAgentsPurchased` integer, nullable: Target seat count of a scheduled reduction (AF-57), null when none is pending.
    - `pendingReductionEffectiveAt` string, date-time, nullable: When the pending reduction lands (= currentPeriodEnd at the time it was scheduled).
    - `cancelAt` string, date-time, nullable: End-of-period cancellation scheduled on Stripe (billing portal): when the service stops. Null when none is scheduled. On a `canceled` subscription: when the service actually stopped.
    - `pendingPaymentActiveAgentsPurchased` integer, nullable: A licence increase whose prorated invoice awaits payment (3DS, declined card): the seat count once paid. Null when nothing is pending.
    - `pendingPaymentInvoiceUrl` string, nullable: The hosted Stripe invoice to pay for `pendingPaymentActiveAgentsPurchased`. Company admins only — omitted for members.
    - `trialSource` 'self_serve' | 'admin_manual', nullable
    - `trialEndAgentCount` integer, nullable
    - `planName` string
    - `planDescription` string
    - `creditsPerAgentPerMonth` integer
    - `billingInterval` 'monthly' | 'annual', nullable
    - `pricePerAgentCents` integer, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `memberRole` 'admin' | 'member', required
  - `activeSessionCount` integer, required
  - `trialActivatedAt` string, date-time, nullable
  - `pausedAgentCount` integer, required
  - `trialDeletionAt` string, date-time, nullable
  - `pendingActiveAgentsPurchased` integer, nullable: Also mirrored at the top level — see CompanySubscription.pendingActiveAgentsPurchased.
  - `pendingReductionEffectiveAt` string, date-time, nullable
  - `trialAllowance` object: Only when `subscription` is null: what activating the self-serve trial now would grant.
    - `maxActiveAgents` integer, required
    - `credits` integer, required

## Other responses

- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `404`: No company

---

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