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

# Get current account subscription

`GET /subscription`

## Request

- Base URL: `https://api.salesforge.ai/public/v2`
- URL: `https://api.salesforge.ai/public/v2/subscription`
- Auth: API key in header `Authorization`

Returns the current plan, billing period, subscription status, trial-plan indicator and credit tiers. contactsAndEmailsTier covers both lead and email; personalizationTier, validationTier and socialActionTier cover their respective credits. plan.credits shows the base plan allowances, with lead and email grouped under contactsAndEmails; tiers show additional allowances. Both are monthly amounts, except lead which is active-contact capacity. isTrial indicates whether the account is on the trial plan, including an expired trial. nextBillingAt is the next billing date in UTC, or null when no renewal is scheduled.

## Response `200`

OK

- ApiAccountSubscriptionResponse
  - `billingPeriod` 'monthly' | 'yearly'
  - `isTrial` boolean
  - `nextBillingAt` string
  - `plan` ApiAccountPlanResponse
    - `credits` ApiAccountPlanCredits
      - `contactsAndEmails` ApiContactsAndEmailsCredits
        - `email` integer
        - `lead` integer
      - `emailValidation` integer
      - `personalization` integer
      - `socialAction` integer
    - `id` string
    - `name` string
  - `subscriptionStatus` 'active' | 'inactive' | 'cancelled' | 'deleted'
  - `tiers` ApiAccountSubscriptionTiers
    - `contactsAndEmailsTier` ApiContactsAndEmailsAllowance
      - `credits` ApiContactsAndEmailsCredits
        - `email` integer
        - `lead` integer
      - `tierId` string
    - `personalizationTier` ApiCreditAllowance
      - `credits` integer
      - `tierId` string
    - `socialActionTier` ApiCreditAllowance
      - `credits` integer
      - `tierId` string
    - `validationTier` ApiCreditAllowance
      - `credits` integer
      - `tierId` string

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

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