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

# Get a plan for a product

> Retrieves a single plan by reference or ID within the given product.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/sdk/products/{productRef}/plans/{planRef}
openapi: 3.0.0
info:
  contact: {}
  description: The SolvaPay REST API specification
  title: SolvaPay REST API
  version: '1.0'
servers: []
security: []
tags: []
paths:
  /v1/sdk/products/{productRef}/plans/{planRef}:
    get:
      tags:
        - Plans
      summary: Get a plan for a product
      description: Retrieves a single plan by reference or ID within the given product.
      operationId: PlanSdkController_getPlan
      parameters:
        - description: Product reference or ID
          in: path
          name: productRef
          required: true
          schema:
            example: prd_1A2B3C4D
            type: string
        - description: Plan reference or ID
          in: path
          name: planRef
          required: true
          schema:
            example: pln_1A2B3C4D
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Plan'
          description: Plan retrieved successfully
        '404':
          description: Plan or product not found
      security:
        - SecretKey: []
components:
  schemas:
    Plan:
      properties:
        accessExpiryDays:
          description: Access expiry in days
          type: number
        billingCycle:
          description: Billing cycle
          example: monthly
          type: string
        billingModel:
          description: Billing model
          enum:
            - pre-paid
            - post-paid
          example: pre-paid
          type: string
        createdAt:
          description: Creation timestamp
          type: string
        creditsPerUnit:
          description: Credits per usage unit (integer, >= 1)
          example: 1
          type: number
        currency:
          description: Currency code (ISO 4217)
          example: USD
          type: string
        currencySymbol:
          description: Currency symbol (derived from currency)
          example: $
          type: string
        description:
          description: Plan description
          example: Best for teams getting started
          type: string
        features:
          additionalProperties: true
          description: Plan features
          type: object
        freeUnits:
          description: Number of free units included
          example: 100
          type: number
        hidden:
          description: >-
            Whether the plan is hidden from customer-facing surfaces. When true,
            the plan does not appear in checkout or the SDK catalog and can only
            be granted via direct assignment (enterprise plans).
          example: false
          type: boolean
        isActive:
          description: Whether the plan is active (derived from status)
          example: true
          type: boolean
        limit:
          description: Usage limit for the meter
          example: 10000
          type: number
        limits:
          additionalProperties: true
          description: Usage limits
          type: object
        maxActiveUsers:
          description: Maximum number of active users
          type: number
        measures:
          description: What the plan measures for usage tracking
          example: requests
          type: string
        meterRef:
          description: Meter reference for usage-based plans
          example: mtr_1A2B3C4D
          type: string
        name:
          description: Plan name
          example: Starter
          type: string
        price:
          description: Plan price in cents
          example: 2999
          type: number
        pricingOptions:
          description: Per-currency price options for this plan
          items:
            $ref: '#/components/schemas/PlanPricingOptionDto'
          type: array
        reference:
          description: Plan reference
          example: pln_1A2B3C4D
          type: string
        requiresPayment:
          description: Whether payment is required
          example: true
          type: boolean
        rolloverUnusedUnits:
          description: Whether unused units roll over to next period
          example: false
          type: boolean
        setupFee:
          description: One-time setup fee
          example: 500
          type: number
        status:
          description: Plan status
          example: active
          type: string
        taxBehavior:
          description: Tax inclusion behavior for business checkout
          enum:
            - auto
            - inclusive
            - exclusive
          type: string
        trialDays:
          description: Free trial period in days
          example: 14
          type: number
        type:
          description: Plan type exposed in SDK
          enum:
            - recurring
            - one-time
            - usage-based
            - hybrid
          example: recurring
          type: string
        updatedAt:
          description: Last update timestamp
          type: string
      required:
        - type
        - reference
        - price
        - currency
        - requiresPayment
        - hidden
        - isActive
        - status
        - createdAt
        - updatedAt
      type: object
    PlanPricingOptionDto:
      properties:
        basePrice:
          description: Base price in smallest currency unit (hybrid plans)
          example: 1999
          type: number
        currency:
          description: ISO 4217 currency code
          example: USD
          type: string
        default:
          description: Whether this is the default currency option for the plan
          example: true
          type: boolean
        price:
          description: Price in smallest currency unit (e.g. cents)
          example: 2999
          type: number
        setupFee:
          description: One-time setup fee in smallest currency unit
          example: 500
          type: number
      required:
        - currency
        - price
      type: object
  securitySchemes:
    SecretKey:
      bearerFormat: JWT
      description: >-
        Provider secret API key (sk_live_… / sk_test_…) supplied as a Bearer
        token.
      scheme: bearer
      type: http

````