Participants

Get participant state history

Retrieve a unified timeline of state changes across tags, counters, attributes, and tiers.

get/v1/participants/{participant_id}/activity/state-history

Request

  • Base URL: https://api.scrip.dev
  • URL: https://api.scrip.dev/v1/participants/{participant_id}/activity/state-history
  • Auth: HTTP bearer

Path parameters

participant_idstring required

The participant's id, or ext: followed by the participant's external_id.

Query parameters

state_type'TAG' | 'COUNTER' | 'ATTRIBUTE' | 'TIER'

Return only changes to this kind of state

keystring

Filter by key

program_idstring uuid

Filter by program ID (for tier entries)

operation'SET' | 'DELETE' | 'AUTO_RESET'

Return only changes of this kind

created_afterstring date-time

Return only entries recorded after this time, RFC 3339.

created_beforestring date-time

Return only entries recorded before this time, RFC 3339.

occurred_afterstring date-time

Return only records whose event occurred after this time, RFC 3339.

occurred_beforestring date-time

Return only records whose event occurred before this time, RFC 3339.

limitinteger

Return at most this many records, from 1 to 200, default 50.

cursorstring

The next_cursor from the previous response, valid only with the same endpoint and filters.

Response

State history entries

Example response

{
  "data": [
    {
      "changed_at": "2027-01-15T10:30:00Z",
      "event_id": "e5dc1b6a-7f3d-4e2a-8c1b-9a0f4d7e6c05",
      "id": "5a7c9e13-d4f6-4b82-8c0a-b2d4f6a8c129",
      "key": "region",
      "new_value": "us-east",
      "old_value": "us-west",
      "operation": "SET",
      "program_id": "8f14e45f-ceea-4e70-9df8-2a7d1b3c9f01",
      "rule_id": "c9f0f895-fb98-4b39-9f86-1e5a0d3e2b03",
      "state_type": "ATTRIBUTE"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "YWJjMTIz"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.