---
title: "List a plan's revisions"
method: GET
path: "/pricing-plans/{planName}/revisions"
tags: ["PricingPlans"]
---

# List a plan's revisions

`GET /pricing-plans/{planName}/revisions`

## Request

- Base URL: `https://api.xfa.tech`
- URL: `https://api.xfa.tech/pricing-plans/{planName}/revisions`
- Auth: HTTP bearer

Every change to the plan, newest first, with what changed and who changed it. Revision 1 is the plan as it was when revision tracking started.

## Path parameters

- `planName` string, required

## Response `200`

The plan's revisions

- object[]
  - `planName` string
  - `revision` integer
  - `definition` GlobalPlanDefinition
    - `planName` string, required
    - `paymentPlan` PaymentPlan, required
      - `Name` string
      - `NrOfPolicies` integer
      - `NrOfDiscovery` integer
      - `AwarenessVerificationFrequency` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'none' | 'on-demand' | 'limited': Frequency interval
      - `AwarenessRiskFrequency` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'none' | 'on-demand' | 'limited': Frequency interval
      - `NrOfEnforcement` integer
      - `CustomIntegration` boolean
      - `AdminSecurityReports` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'none' | 'on-demand' | 'limited': Frequency interval
      - `Cves` boolean
      - `Mfa` boolean
      - `AdvancedMfa` boolean
      - `ExportToGRC` boolean
      - `ApplyDuringTrial` boolean
    - `featureFlags` string[], required
    - `pricing` PlanPricing
      - `monthlyPricePerSeat` number, float, nullable
      - `yearlyPricePerSeat` number, float, nullable
      - `currency` 'EUR' | 'USD' | 'GBP': Supported currencies
      - `minimumSeats` integer
    - `revision` integer: Assigned by the billing service on every change and ignored on a PUT body. 0 for a plan not changed since revision tracking started (it counts as revision 1).
  - `changes` object
    - `paymentPlan` object[]
      - `field` string
      - `from` unknown
      - `to` unknown
    - `flagsAdded` string[]
    - `flagsRemoved` string[]
    - `pricingChanged` boolean
  - `changedBy` string: Email of the sys admin who made the change, or a system actor
  - `changedAt` string, date-time

---

[API](https://skmtc.dev/xfa/apis/xfa-api.md) · [All operations](https://skmtc.dev/xfa/apis/xfa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xfa/apis/xfa-api/revisions/1a1be0e8972b?raw)
