@inklok/api-spec 7.6.2 → 7.7.0

package/openapi.yaml

@@ -8,7 +8,7 @@ info:
     Authenticate using an API key or bearer token, then use the resources below to manage
     templates, agreements, documents, and signing. For your first integration, start with
     the Quick Start guide.
-  version: "7.6.2"
+  version: "7.7.0"
   contact:
     name: Inklok API Support
     email: support@inklok.com
@@ -325,6 +325,29 @@ paths:
         '500':
           $ref: '#/components/responses/InternalServerError'
 
+  /me/billing:
+    get:
+      operationId: getMeBilling
+      summary: Get billing state for the current account
+      x-internal: true
+      x-visibility: internal
+      description: |
+        Returns the authenticated account's Billing Subscription authority record
+        and the derived entitlement projection used by the application UI.
+      tags:
+        - Me
+      responses:
+        '200':
+          description: Successfully retrieved billing state
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MeBillingResponse'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
+
   /platform/overview:
     get:
       operationId: getPlatformOverview
@@ -3639,6 +3662,86 @@ components:
         profile:
           $ref: '#/components/schemas/BootstrapProfile'
 
+    MeBillingSubscription:
+      type: object
+      additionalProperties: false
+      required:
+        - source
+        - currentPlan
+        - status
+        - billingInterval
+        - currentBillingPeriodStart
+        - currentBillingPeriodEnd
+        - renewalDate
+        - cancelAtPeriodEnd
+        - paddleCustomerId
+        - paddleSubscriptionId
+        - nextBilledAt
+        - nextExpectedBillingTransition
+      properties:
+        source:
+          type: string
+          enum: [PADDLE, INTERNAL]
+        currentPlan:
+          type: string
+          enum: [free, pro, team, enterprise]
+        status:
+          type: string
+        billingInterval:
+          type: string
+          enum: [day, week, month, year, unknown]
+        currentBillingPeriodStart:
+          type: string
+          format: date-time
+          nullable: true
+        currentBillingPeriodEnd:
+          type: string
+          format: date-time
+          nullable: true
+        renewalDate:
+          type: string
+          format: date-time
+          nullable: true
+        cancelAtPeriodEnd:
+          type: boolean
+        paddleCustomerId:
+          type: string
+          nullable: true
+        paddleSubscriptionId:
+          type: string
+          nullable: true
+        nextBilledAt:
+          type: string
+          format: date-time
+          nullable: true
+        nextExpectedBillingTransition:
+          type: string
+          format: date-time
+          nullable: true
+
+    MeBillingResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - accountId
+        - plan
+        - subscriptionStatus
+        - limits
+        - billingSubscription
+      properties:
+        accountId:
+          type: string
+        plan:
+          type: string
+          enum: [free, pro, team, enterprise]
+        subscriptionStatus:
+          type: string
+        limits:
+          type: object
+          additionalProperties: true
+        billingSubscription:
+          $ref: '#/components/schemas/MeBillingSubscription'
+
     PlatformDailyEmailCounts:
       type: object
       required:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inklok/api-spec",
-  "version": "7.6.2",
+  "version": "7.7.0",
   "description": "Canonical OpenAPI specification for the Inklok public API.",
   "main": "openapi.yaml",
   "license": "MIT",