Skip to main content
GET
/
v1
/
rules
/
{id}
/
history
Get rule change history
curl --request GET \
  --url https://api.scrip.dev/v1/rules/{id}/history \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "change_type": "updated",
      "changed_at": "2026-02-22T21:00:00Z",
      "changed_by_api_key_id": "550e8400-e29b-41d4-a716-446655440003",
      "changed_by_user_id": "550e8400-e29b-41d4-a716-446655440004",
      "changes": {},
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "program_id": "550e8400-e29b-41d4-a716-446655440002",
      "rule_id": "550e8400-e29b-41d4-a716-446655440001",
      "snapshot": {}
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "YWJjMTIz"
  }
}
Returns the audit trail of changes for a specific rule. Each entry records a change_type, a timestamp, who made the change, and a snapshot of the full rule at that point in time. The changes object highlights which fields were modified. Use the change_type query parameter to filter by lifecycle event: created, updated, archived, suspended, or activated.
For usage patterns and examples, see the Writing Rules guide.

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header.

Path Parameters

​
id
string<uuid>
required

Rule ID

Query Parameters

​
change_type
enum<string>

Filter by change type

Available options:
created,
updated,
archived,
suspended,
activated
​
from
string<date-time>

Start of time window (RFC 3339)

​
to
string<date-time>

End of time window (RFC 3339)

​
limit
integer
default:20

Maximum number of results (default 20, max 100)

Required range: x >= 1
​
cursor
string

Pagination cursor from previous response

Response

Rule change history

​
data
object[]

Data contains the list of items

​
pagination
object

Pagination contains cursor information for fetching more results