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

# Get a commission plan

> **Beta. This endpoint is unstable and may still change without notice.** Pin against the dated version and watch the changelog.

Fetch a single commission plan by id.



## OpenAPI

````yaml assets/openapi-v2-commission.json get /api/commissions/plans/{id}
openapi: 3.1.0
info:
  title: Fynn V2 Commission API
  version: 2026-07
  description: >-
    REST API for Fynn commission plans. Define how sales reps earn commission on
    invoices, set per-product rates, and control two monthly payout gates: a
    minimum payout and a minimum monthly revenue, each evaluated per sales rep
    and calendar month. Authenticate with a bearer token of your Organisation
    that carries the commission-plans permission.
servers:
  - url: https://coreapi.io
    description: Production
  - url: https://preview.coreapi.io
    description: Sandbox
security:
  - BearerToken: []
tags:
  - name: Commission Plans
    description: >-
      Create and manage commission plans, rates, product rules and monthly
      payout gates.
paths:
  /api/commissions/plans/{id}:
    get:
      tags:
        - Commission Plans
      summary: Get a commission plan
      description: >-
        **Beta. This endpoint is unstable and may still change without notice.**
        Pin against the dated version and watch the changelog.


        Fetch a single commission plan by id.
      operationId: getCommissionPlan
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The commission plan id.
      responses:
        '200':
          description: The commission plan.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommissionPlan'
        '401':
          description: Authentication is missing or the token is invalid.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
        '403':
          description: The token lacks the permission to read commission plans.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
        '404':
          description: No commission plan with this id exists in your Organisation.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
components:
  schemas:
    CommissionPlan:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        type:
          type: string
        percentage:
          type: string
          nullable: true
          description: Base commission rate as a decimal fraction.
        basisType:
          type: string
          nullable: true
        triggerEvent:
          type: string
        commissionScope:
          type: string
        requireDeal:
          type: boolean
        payoutThresholdAmount:
          type: object
          properties:
            amount:
              type: integer
              description: Amount in the currency's minor unit (e.g. cents).
            displayAmount:
              type: number
              description: The amount as a decimal, for display.
            currency:
              type: string
              description: ISO 4217 currency code.
            precision:
              type: integer
              description: Number of minor-unit decimals.
          nullable: true
          description: >-
            Minimum commission a sales rep must accumulate on this plan within a
            calendar month for that month's commissions to be paid out.
            Evaluated per sales rep, per plan, per month. Null means no minimum.
        monthlyRevenueThreshold:
          type: object
          properties:
            amount:
              type: integer
              description: Amount in the currency's minor unit (e.g. cents).
            displayAmount:
              type: number
              description: The amount as a decimal, for display.
            currency:
              type: string
              description: ISO 4217 currency code.
            precision:
              type: integer
              description: Number of minor-unit decimals.
          nullable: true
          description: >-
            Minimum invoice revenue a sales rep must generate on this plan
            within a calendar month before any commission for that month is paid
            out. If the revenue stays below this, the whole month is withheld.
            Evaluated per sales rep, per plan, per month. Null means no minimum.
        isActive:
          type: boolean
        rules:
          type: array
          items:
            $ref: '#/components/schemas/CommissionPlanRule'
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    ProblemError:
      type: object
      description: >-
        Problem detail error body (application/problem+json). Additional members
        may be present depending on the error.
      properties:
        status:
          type: integer
          example: 404
        type:
          type: string
          description: Stable machine readable error key.
          example: PLAN__NOT_FOUND
        title:
          type: string
          example: An error occurred
        detail:
          type: string
          example: Plan not found.
      required:
        - status
        - type
        - title
        - detail
    CommissionPlanRule:
      type: object
      properties:
        id:
          type: string
        productId:
          type: string
          nullable: true
        externalProductReference:
          type: string
          nullable: true
        percentage:
          type: string
          description: Commission rate as a decimal fraction (0.20 = 20 %).
        priority:
          type: integer
  securitySchemes:
    BearerToken:
      type: http
      scheme: bearer
      description: >-
        Bearer token of your Organisation with the commission-plans permission
        (read for GET, write for POST/PUT/DELETE). Send it as Authorization:
        Bearer <token>.

````