Get group state history
Activity
Get group state history
Retrieve a unified timeline of state changes across tags, counters, attributes, and tiers. For authoritative tier transition details, use the tier transitions endpoint.
GET
Get group state history
Returns a unified timeline of state changes for a group, including tags, counters, attributes, and tiers. Each entry includes:
state_type: what changed (tag,attribute,counter, ortier)key: the specific key that was modifiedoperation:setordeleteold_value/new_value: the value before and after the changeevent_id: present when the change was triggered by a rule during event processingchanged_by_api_key_id: present when the change was made via a direct API call
state_type and key query parameters to filter results. Filter by state_type=tier and provide a program_id to isolate tier transitions.
For usage patterns and examples, see the Groups guide.
Authorizations
API key passed in the X-API-Key header.
Path Parameters
Group ID
Query Parameters
Filter by state type
Available options:
tag, counter, attribute, tier Filter by key
Filter by program ID (for tier entries)
Filter by operation
Available options:
set, delete, add, remove, auto_reset Start of time window (RFC 3339)
End of time window (RFC 3339)
Maximum number of results
Required range:
x >= 1Pagination cursor