---
title: "List every revision of a rule, newest first"
method: GET
path: "/v1/rules/{lineageId}/revisions"
tags: ["Rules"]
---

# List every revision of a rule, newest first

`GET /v1/rules/{lineageId}/revisions`

## Request

- Base URL: `https://api.ironfang.com/audit`
- URL: `https://api.ironfang.com/audit/v1/rules/{lineageId}/revisions`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the revision history for the organisation's rule in descending version order, preserving access to the configurations referenced by earlier audit results.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Revisions

- RuleRevisionList
  - `next_cursor` string: The version to continue below. Absent on the final page.
  - `revisions` RuleRevision[], required
    - `configuration` unknown, required
    - `created_at` string, date-time, required
    - `created_by` string
    - `description` string
    - `enabled` boolean
    - `id` string, uuid, required
    - `lineage_id` string, uuid, required
    - `name` string, required
    - `organisation_id` string, uuid, required
    - `origin_pack_installation_id` string
    - `origin_pack_rule_key` string
    - `retired_at` string, date-time
    - `rule_type` string, required
    - `severity` 'info' | 'warning' | 'failure' | 'critical', required
    - `site_id` string
    - `supersedes_rule_id` string
    - `version` integer, required

## Other responses

- `400`: Problem response
- `404`: Problem response

---

[API](https://skmtc.dev/ironfang/apis/ironfang-audit-api.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-audit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-audit-api/revisions/7430deff2cbd?raw)