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

# Current tenant subscription

> Returns the tenant plan, limits, and usage snapshot. Payment and plan changes happen inside the tenant dashboard.



## OpenAPI

````yaml /openapi/sinjapp-business.v1.yaml get /subscription
openapi: 3.0.3
info:
  title: Sinjapp Business API
  version: 1.0.0
  description: |
    Sinjapp Business exposes a Tenant API for customer messaging operations.
  license:
    name: Proprietary
    url: https://sinjapp.com/legal/terms
servers:
  - url: '{tenantBaseUrl}/api/v1'
    description: Tenant API
    variables:
      tenantBaseUrl:
        default: https://your-tenant.sinjapp.org
        description: >-
          Full customer tenant URL, including https://. Use the exact tenant
          workspace domain shown in the dashboard.
security:
  - ApiKeyAuth: []
tags:
  - name: Auth
    description: Tenant identity and runtime context.
  - name: Subscription
    description: >-
      Tenant subscription status. Payment and plan changes happen inside the
      tenant dashboard.
  - name: API Keys
    description: Tenant API credentials and scopes.
  - name: Sender Numbers
    description: Sender number registration and activation state.
  - name: Messages
    description: Sending and reading message logs.
  - name: Contacts
    description: Contact reachability checks.
  - name: Usage
    description: Usage counters and limits.
paths:
  /subscription:
    get:
      tags:
        - Subscription
      summary: Current tenant subscription
      description: >-
        Returns the tenant plan, limits, and usage snapshot. Payment and plan
        changes happen inside the tenant dashboard.
      operationId: getTenantSubscription
      responses:
        '200':
          description: Current tenant subscription, plan, limits, and usage.
          content:
            application/json:
              schema:
                type: object
                properties:
                  plan:
                    type: object
                    nullable: true
                  status:
                    type: string
                    nullable: true
                  limits:
                    type: array
                    items:
                      type: object
                  usage_snapshot:
                    type: object
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/TenantNotFound'
components:
  responses:
    Unauthorized:
      description: Missing, invalid, expired, or insufficient API credentials.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthenticated.
    TenantNotFound:
      description: The request host does not match a known tenant workspace domain.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Tenant could not be identified for this domain.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````