Skip to content

List audiences

GET
/content/management/v1/audiences
curl --request GET \
--url https://api.ebitex.io/content/management/v1/audiences \
--header 'Authorization: Bearer <token>'

Lists every audience in the key’s environment, ordered by external id. An audience is a named, reusable condition on the visitor context a delivery request sends as ctx; personalized fields and inline variants refer to it by id to decide which variant a visitor sees.

Key: a management key with content.management.read.

An array of { id, externalId, name, predicate, sourceEnvironmentId }. sourceEnvironmentId is set when the audience is inherited from another environment.

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired.

payment_required: the organization’s subscription needs attention.

scope_denied: the key lacks this route’s scope. tier_required: the Content Management API needs the Pro plan or above. ip_denied: the caller’s address is outside the key’s allowed ranges. app_not_available: Content is not enabled for the organization.

Rate limit or quota exceeded; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.