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

# Get current account subscription

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



## OpenAPI

````yaml https://api.salesforge.ai/public/v2/swagger/doc.json get /subscription
openapi: 3.1.0
info:
  description: Get mailboxes associated with the workspace.
  termsOfService: https://www.salesforge.ai/terms
  title: Salesforge API
  version: '2.0'
servers:
  - url: https://api.salesforge.ai/public/v2
security:
  - ApiKeyAuth: []
externalDocs:
  description: ''
  url: ''
paths:
  /subscription:
    get:
      tags:
        - account
      summary: Get current account subscription
      description: >-
        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.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.AccountSubscriptionResponse'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors.Error'
          description: Internal Server Error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    api.AccountSubscriptionResponse:
      properties:
        billingPeriod:
          $ref: '#/components/schemas/models.AccountBillingPeriod'
        isTrial:
          type: boolean
        nextBillingAt:
          type: string
        plan:
          $ref: '#/components/schemas/api.AccountPlanResponse'
        subscriptionStatus:
          $ref: '#/components/schemas/models.AccountSubscriptionStatus'
        tiers:
          $ref: '#/components/schemas/api.AccountSubscriptionTiers'
      type: object
    errors.Error:
      allOf:
        - $ref: '#/components/schemas/data'
      properties:
        data: {}
        message:
          type: string
      type: object
    models.AccountBillingPeriod:
      enum:
        - monthly
        - yearly
      type: string
      x-enum-varnames:
        - AccountBillingPeriodMonthly
        - AccountBillingPeriodYearly
    api.AccountPlanResponse:
      properties:
        credits:
          $ref: '#/components/schemas/api.AccountPlanCredits'
        id:
          type: string
        name:
          type: string
      type: object
    models.AccountSubscriptionStatus:
      enum:
        - active
        - inactive
        - cancelled
        - deleted
      type: string
      x-enum-varnames:
        - AccountSubscriptionStatusActive
        - AccountSubscriptionStatusInactive
        - AccountSubscriptionStatusCancelled
        - AccountSubscriptionStatusDeleted
    api.AccountSubscriptionTiers:
      properties:
        contactsAndEmailsTier:
          $ref: '#/components/schemas/api.ContactsAndEmailsAllowance'
        personalizationTier:
          $ref: '#/components/schemas/api.CreditAllowance'
        socialActionTier:
          $ref: '#/components/schemas/api.CreditAllowance'
        validationTier:
          $ref: '#/components/schemas/api.CreditAllowance'
      type: object
    data:
      properties:
        data:
          items:
            $ref: '#/components/schemas/api.DNCResponse'
          type: array
      type: object
    api.AccountPlanCredits:
      properties:
        contactsAndEmails:
          $ref: '#/components/schemas/api.ContactsAndEmailsCredits'
        emailValidation:
          type: integer
        personalization:
          type: integer
        socialAction:
          type: integer
      type: object
    api.ContactsAndEmailsAllowance:
      properties:
        credits:
          $ref: '#/components/schemas/api.ContactsAndEmailsCredits'
        tierId:
          type: string
      type: object
    api.CreditAllowance:
      properties:
        credits:
          type: integer
        tierId:
          type: string
      type: object
    api.DNCResponse:
      properties:
        createdAt:
          type: string
        type:
          $ref: '#/components/schemas/models.DncType'
        value:
          type: string
      type: object
    api.ContactsAndEmailsCredits:
      properties:
        email:
          type: integer
        lead:
          type: integer
      type: object
    models.DncType:
      enum:
        - email
        - domain
        - linkedin
      type: string
      x-enum-varnames:
        - DncTypeEmail
        - DncTypeDomain
        - DncTypeLinkedin
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: Authorization
      type: apiKey

````