API Reference
Track policy changes
Get a feed of policy updates and modifications over time.
Authorization
bearerAuth AuthorizationBearer <token>
API keys are prefixed with vrt_live_ for production or vrt_test_ for testing.
Example: vrt_live_abc123xyz
In: header
Query Parameters
since?string
ISO8601 timestamp - only show changes after this date
Format
date-timepolicy_id?string
Filter to a specific policy
Length
length <= 50change_type?string
Filter by change type
Value in
"created" | "updated" | "retired" | "codes_changed" | "criteria_changed" | "metadata_changed"cursor?string
Pagination cursor
limit?integer
Results per page
Default
50Range
1 <= value <= 100Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://verity.backworkai.com/api/v1/policies/changes?since=2024-01-01T00%3A00%3A00Z"{
"success": true,
"data": [
{
"diff_id": 0,
"policy_id": "string",
"policy_title": "string",
"old_version": "string",
"new_version": "string",
"change_type": "created",
"change_summary": "string",
"changed_at": "2019-08-24T14:15:22Z",
"details": {
"changed_fields": [
"string"
],
"added_codes": [
"string"
],
"removed_codes": [
"string"
],
"modified_criteria": [
"string"
]
}
}
],
"meta": {
"pagination": {
"cursor": "eyJpZCI6MTIzfQ",
"has_more": true,
"limit": 50
},
"filters": {
"since": "string",
"policy_id": "string",
"change_type": "string"
}
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid query parameters",
"hint": "Check the 'code' parameter format",
"details": {}
},
"meta": {
"request_id": "req_abc123"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid query parameters",
"hint": "Check the 'code' parameter format",
"details": {}
},
"meta": {
"request_id": "req_abc123"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid query parameters",
"hint": "Check the 'code' parameter format",
"details": {}
},
"meta": {
"request_id": "req_abc123"
}
}