Tiers

Set participant tier

Directly set a participant's tier to a specific level, optionally with an expiration.

put/v1/participants/{participant_id}/state/tiers/{tier_key}

Request

Base URL: https://api.scrip.dev
URL: https://api.scrip.dev/v1/participants/{participant_id}/state/tiers/{tier_key}
Auth: HTTP bearer

Path parameters

participant_idstring required

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

tier_keystring required

The tier's key, such as status.

Query parameters

program_idstring uuid required

Program ID

Request body

expires_atstring date-time

When this tier assignment expires (RFC 3339, null for no expiration)

levelstring required

Key of the level to assign (e.g., gold)

Example request

{
  "expires_at": "2027-12-31T23:59:59Z",
  "level": "gold"
}

Response

Updated tier state

acquired_atstring date-time

When this tier level was earned

benefitsobject

Benefits granted by this tier level

expires_atstring date-time

When this tier level expires

levelstring

Current tier level name

rankinteger

Numeric rank within the tier (higher = better)

Example response

{
  "acquired_at": "2027-01-15T10:30:00Z",
  "benefits": {
    "discount_pct": 10,
    "free_shipping": true
  },
  "expires_at": "2027-12-31T23:59:59Z",
  "level": "gold",
  "rank": 2
}

Changes

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