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

# Get an offer version

> Resolves a standalone offer-version id together with its parent offer — e.g. a BFF resolving pricing/plan details from a subscription product's offerVersionId.



## OpenAPI

````yaml GET /offer-versions/{offerVersionId}
openapi: 3.1.0
info:
  title: Wave Lines API
  version: 1.0.0
servers: []
security:
  - apiKey: []
tags:
  - name: lines
    description: Line lifecycle operations
  - name: payments
    description: Payment listing and lookup
  - name: payment-methods
    description: Payment method lifecycle operations
  - name: tax-receipts
    description: Tax receipt listing, lookup and document download
  - name: subscriptions
    description: Subscription lookup, product management and invoices
  - name: holders
    description: Holder (customer) listing, lookup and creation
  - name: usage
    description: 'Usage: per-product line balance and consumption'
  - name: Portability
    description: >-
      Number portability: port-in request creation, listing, modification and
      cancellation, plus the consolidated portability status
  - name: Inventory
    description: >-
      Inventory resource pools: pool listing, the resources held in a pool and
      resource reservations
  - name: Catalog
    description: Catalog offers exposed by the Wave Catalog API
paths:
  /offer-versions/{offerVersionId}:
    get:
      tags:
        - Catalog
      summary: Get an offer version by id
      description: >-
        Resolves a standalone offer-version id together with its parent offer —
        e.g. a BFF resolving pricing/plan details from a subscription product's
        offerVersionId.
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: offerVersionId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  offerId:
                    type: string
                  versionNumber:
                    type: integer
                  status:
                    type: string
                    enum:
                      - DRAFT
                      - APPROVING
                      - ACTIVE
                      - DEPRECATED
                  createdAt:
                    type: string
                  publishedAt:
                    type:
                      - 'null'
                      - string
                  updatedAt:
                    type:
                      - 'null'
                      - string
                  validityStart:
                    type:
                      - 'null'
                      - string
                  validityEnd:
                    type:
                      - 'null'
                      - string
                  metadata:
                    anyOf:
                      - type: object
                        additionalProperties:
                          type:
                            - string
                            - number
                            - boolean
                            - 'null'
                      - type: 'null'
                  totalPrice:
                    type: string
                  hasUsageBasedItems:
                    type: boolean
                  ruleId:
                    type:
                      - 'null'
                      - string
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        pricing:
                          anyOf:
                            - type: object
                              properties:
                                model:
                                  type: string
                                  enum:
                                    - STANDARD
                                properties:
                                  type: object
                                  properties:
                                    price:
                                      type: string
                                    payInAdvance:
                                      type: boolean
                                  required:
                                    - price
                                  additionalProperties: false
                              required:
                                - model
                                - properties
                              additionalProperties: false
                            - type: object
                              properties:
                                model:
                                  type: string
                                  enum:
                                    - PERCENTAGE
                                properties:
                                  type: object
                                  properties:
                                    billableMetricId:
                                      type: string
                                    rate:
                                      type: string
                                  required:
                                    - billableMetricId
                                    - rate
                                  additionalProperties: false
                              required:
                                - model
                                - properties
                              additionalProperties: false
                            - type: object
                              properties:
                                model:
                                  type: string
                                  enum:
                                    - FLAT
                                properties:
                                  type: object
                                  properties:
                                    billableMetricId:
                                      type: string
                                    unitPrice:
                                      type: string
                                  required:
                                    - billableMetricId
                                    - unitPrice
                                  additionalProperties: false
                              required:
                                - model
                                - properties
                              additionalProperties: false
                            - type: object
                              properties:
                                model:
                                  type: string
                                  enum:
                                    - GRADUATED
                                properties:
                                  type: object
                                  properties:
                                    billableMetricId:
                                      type: string
                                    ranges:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          fromValue:
                                            type: number
                                          toValue:
                                            type: number
                                          perUnitPrice:
                                            type: string
                                          flatPrice:
                                            type: string
                                        required:
                                          - fromValue
                                        additionalProperties: false
                                  required:
                                    - billableMetricId
                                    - ranges
                                  additionalProperties: false
                              required:
                                - model
                                - properties
                              additionalProperties: false
                            - type: object
                              properties:
                                model:
                                  type: string
                                  enum:
                                    - PACKAGE
                                properties:
                                  type: object
                                  properties:
                                    billableMetricId:
                                      type: string
                                    packageSize:
                                      type: number
                                    price:
                                      type: string
                                    freeUnits:
                                      type: number
                                  required:
                                    - billableMetricId
                                    - packageSize
                                    - price
                                  additionalProperties: false
                              required:
                                - model
                                - properties
                              additionalProperties: false
                        quantity:
                          type: number
                        billable:
                          type: boolean
                        billableFromCycle:
                          anyOf:
                            - type: integer
                            - type: 'null'
                        validity:
                          anyOf:
                            - type: object
                              properties:
                                duration:
                                  type: integer
                                unit:
                                  type: string
                                  enum:
                                    - CYCLES
                                    - DAYS
                                    - MONTHS
                              required:
                                - duration
                                - unit
                              additionalProperties: false
                            - type: 'null'
                        currency:
                          type: string
                        usageBased:
                          type: boolean
                        component:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type:
                                - 'null'
                                - string
                            category:
                              type:
                                - 'null'
                                - string
                          required:
                            - id
                          additionalProperties: false
                      required:
                        - id
                        - pricing
                        - quantity
                        - billable
                        - currency
                        - usageBased
                        - component
                      additionalProperties: false
                  discounts:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        discount:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            method:
                              type: string
                              enum:
                                - AUTOMATIC
                                - COUPON
                            couponCode:
                              type:
                                - 'null'
                                - string
                            frequency:
                              type: string
                              enum:
                                - ONCE
                                - RECURRING
                            status:
                              type: string
                              enum:
                                - ACTIVE
                                - TERMINATED
                            value:
                              type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - FIXED_AMOUNT
                                    - PERCENTAGE
                                amount:
                                  type: string
                                currency:
                                  type:
                                    - 'null'
                                    - string
                              required:
                                - type
                                - amount
                              additionalProperties: false
                            combinationMode:
                              type: string
                              enum:
                                - CUMULATIVE
                                - EXCLUSIVE
                            ruleId:
                              type:
                                - 'null'
                                - string
                          required:
                            - id
                            - name
                            - method
                            - frequency
                            - status
                            - value
                            - combinationMode
                          additionalProperties: false
                        componentId:
                          type:
                            - 'null'
                            - string
                        scope:
                          type: string
                          enum:
                            - OFFER
                            - OFFER_ITEM
                        fromCycle:
                          type: integer
                        durationInCycles:
                          anyOf:
                            - type: integer
                            - type: 'null'
                        maxRedemptions:
                          anyOf:
                            - type: integer
                            - type: 'null'
                        oncePerCustomer:
                          type: boolean
                        redemptionCount:
                          type: integer
                        removedAt:
                          type:
                            - 'null'
                            - string
                        isActive:
                          type: boolean
                      required:
                        - id
                        - discount
                        - scope
                        - fromCycle
                        - oncePerCustomer
                        - redemptionCount
                        - isActive
                      additionalProperties: false
                  activeSubscriptionsCount:
                    type: integer
                    minimum: 0
                  offer:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      isAddon:
                        type: boolean
                      externalCode:
                        type:
                          - 'null'
                          - string
                    required:
                      - id
                      - name
                      - isAddon
                      - externalCode
                    additionalProperties: false
                required:
                  - id
                  - offerId
                  - versionNumber
                  - status
                  - createdAt
                  - totalPrice
                  - hasUsageBasedItems
                  - items
                  - discounts
                  - activeSubscriptionsCount
                  - offer
                additionalProperties: false
        '400':
          description: Error response as an RFC 9457 problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 problem details error response.
                required:
                  - type
                  - title
                  - status
                additionalProperties: true
                properties:
                  type:
                    type: string
                    description: A URI reference that identifies the problem type.
                    enum:
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/validation-error
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/unauthorized
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/forbidden
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/not-found
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/conflict
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/invalid-status-transition
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/internal-server-error
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/not-acceptable
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/portability-rejected
                  title:
                    type: string
                    description: A short, human-readable summary of the problem type.
                  status:
                    type: integer
                    description: The HTTP status code.
                  detail:
                    type: string
                    description: >-
                      A human-readable explanation specific to this occurrence
                      of the problem.
                  instance:
                    type: string
                    description: >-
                      A URI reference that identifies the specific occurrence of
                      the problem.
        '401':
          description: Error response as an RFC 9457 problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 problem details error response.
                required:
                  - type
                  - title
                  - status
                additionalProperties: true
                properties:
                  type:
                    type: string
                    description: A URI reference that identifies the problem type.
                    enum:
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/validation-error
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/unauthorized
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/forbidden
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/not-found
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/conflict
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/invalid-status-transition
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/internal-server-error
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/not-acceptable
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/portability-rejected
                  title:
                    type: string
                    description: A short, human-readable summary of the problem type.
                  status:
                    type: integer
                    description: The HTTP status code.
                  detail:
                    type: string
                    description: >-
                      A human-readable explanation specific to this occurrence
                      of the problem.
                  instance:
                    type: string
                    description: >-
                      A URI reference that identifies the specific occurrence of
                      the problem.
        '404':
          description: Error response as an RFC 9457 problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 problem details error response.
                required:
                  - type
                  - title
                  - status
                additionalProperties: true
                properties:
                  type:
                    type: string
                    description: A URI reference that identifies the problem type.
                    enum:
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/validation-error
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/unauthorized
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/forbidden
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/not-found
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/conflict
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/invalid-status-transition
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/internal-server-error
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/not-acceptable
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/portability-rejected
                  title:
                    type: string
                    description: A short, human-readable summary of the problem type.
                  status:
                    type: integer
                    description: The HTTP status code.
                  detail:
                    type: string
                    description: >-
                      A human-readable explanation specific to this occurrence
                      of the problem.
                  instance:
                    type: string
                    description: >-
                      A URI reference that identifies the specific occurrence of
                      the problem.
        '500':
          description: Error response as an RFC 9457 problem detail.
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 problem details error response.
                required:
                  - type
                  - title
                  - status
                additionalProperties: true
                properties:
                  type:
                    type: string
                    description: A URI reference that identifies the problem type.
                    enum:
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/validation-error
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/unauthorized
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/forbidden
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/not-found
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/conflict
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/invalid-status-transition
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/internal-server-error
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/not-acceptable
                      - >-
                        https://docs.bemobiwave.com/api-reference/errors/portability-rejected
                  title:
                    type: string
                    description: A short, human-readable summary of the problem type.
                  status:
                    type: integer
                    description: The HTTP status code.
                  detail:
                    type: string
                    description: >-
                      A human-readable explanation specific to this occurrence
                      of the problem.
                  instance:
                    type: string
                    description: >-
                      A URI reference that identifies the specific occurrence of
                      the problem.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key

````