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

# Get subscription revenue metrics for a specific version

> Returns the monthly recurring revenue (MRR), annual recurring revenue (ARR), and annual contract value (ACV) computed from the pricing on the specified subscription version. This is the same calculation used in the Alguna dashboard subscription builder, so results match what is shown there one-to-one.



## OpenAPI

````yaml /api-reference/v2/specs/2026-04-01.json get /subscriptions/{id}/versions/{vid}/revenue
openapi: 3.1.0
info:
  title: Alguna Public API
  version: '2026-04-01'
servers:
  - url: https://api.alguna.io
security:
  - bearerAuth: []
tags:
  - name: Billing Events and Metrics
  - name: Credit Notes
  - name: Credits
  - name: Customer Portal Sessions
  - name: Customers
  - name: Insights
  - name: Invoices
  - name: Payments
  - name: Plans
  - name: Product Bundles
  - name: Products
  - name: Refunds
  - name: Revenue Schedules
  - name: Subscription Changes
  - name: Subscription Versions
  - name: Subscriptions
  - name: Wallet Grants
  - name: Wallets
paths:
  /subscriptions/{id}/versions/{vid}/revenue:
    get:
      tags:
        - Subscription Versions
      summary: Get subscription revenue metrics for a specific version
      description: >-
        Returns the monthly recurring revenue (MRR), annual recurring revenue
        (ARR), and annual contract value (ACV) computed from the pricing on the
        specified subscription version. This is the same calculation used in the
        Alguna dashboard subscription builder, so results match what is shown
        there one-to-one.
      operationId: get-subscription-version-revenue
      parameters:
        - in: header
          name: Alguna-Version
          required: true
          schema:
            enum:
              - '2026-04-01'
            type: string
        - in: path
          name: id
          required: true
          schema:
            description: Unique identifier for the subscription
            type: string
        - in: path
          name: vid
          required: true
          schema:
            description: Unique identifier for the version
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionRevenueResponse'
          description: Success
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal Server Error
components:
  schemas:
    SubscriptionRevenueResponse:
      properties:
        acv:
          description: Annual contract value
          example: '6000.00'
          type: string
        arr:
          description: Annual recurring revenue
          example: '6000.00'
          type: string
        currency:
          description: ISO 4217 currency code
          example: USD
          type: string
        mrr:
          description: Monthly recurring revenue
          example: '500.00'
          type: string
        subscription_id:
          description: Subscription ID
          example: sub_abc123
          type: string
      required:
        - acv
        - arr
        - currency
        - mrr
        - subscription_id
      type: object
    ErrorResponse:
      properties:
        detail:
          type: string
        status:
          format: int64
          type: integer
      required:
        - status
        - detail
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: API Key
      description: API key authentication. Pass your API key as a Bearer token.
      scheme: bearer
      type: http

````