Skip to content
Oclavex is in private preview, available to selected users. Public signup is blocked. Request access at [email protected].

Retrieves a rating campaign by id.

GET
/api/v1/provision/admin/rating-campaigns/{id}
curl --request GET \
--url https://example.com/api/v1/provision/admin/rating-campaigns/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0
id
required
string format: uuid

OK

A rating campaign: a transient ask (“how is export working out this quarter?”) layered over the permanent feature catalog. A user is prompted about a targeted feature only while the campaign is running, only if they are entitled to that feature, and, when the campaign names offers, only if their entitlement was made from one of them.

object
id
string format: uuid
name
string
description
null | string
isEnabled
boolean
startsAt
null | string format: date-time
endsAt
null | string format: date-time
isRunning

True when the campaign is enabled and the current time is inside its window.

boolean
targets
Array<object>

A campaign target as returned by the admin API, denormalized with the feature’s display fields.

object
featureCatalogId
string format: uuid
featureCode
string
featureName
string
question

Question shown for this feature; null or empty falls back to the generic prompt.

null | string
priority

Lower is asked first. Null means no set order — reached by recent usage only.

null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
offers

The offers whose customers are asked. Empty asks every customer.

Array<object>

An offer whose customers a campaign asks, with the offer’s name and version.

object
offerId

The offer. A customer is one of its customers when their entitlement was made from it.

string format: uuid
name

The offer’s name; null when the offer no longer exists.

null | string
version

The offer’s version.

null | string
creationTimeStamp
string format: date-time
lastUpdateTimeStamp
null | string format: date-time
revisionNumber
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/

Not Found

object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string