Sign in

v2

latestOpenAPI 3.1.12026-07-2613060964.2 KB

Get Tenant Preference Single Category

API to get tenant preference for a specific category.

get/v1/tenant/{tenant_id}/preference/category/{category}/

Path parameters

tenant_idstring required

unique identifier of the tenant you want to get preferences for

categorystring required

notification category slug. You can get this from Notification Categories page on SuprSend dashboard -> Settings page

Query parameters

localestring

Locale code (e.g., es, fr, de, ja, es-AR) to fetch preference translations in user's locale. When provided, the API looks for category and section names and descriptions in the respective locale file. If a translation is missing for the requested locale, the system automatically falls back in this order: locale-region (e.g., es-AR) → locale (e.g., es) → en (English - always available).

Response

200

namestring
categorystring
descriptionstring nullable
tagsstring[] nullable
effective_tagsstring[] nullable
root_category'system' | 'transactional' | 'promotional'

Root category (system, transactional, or promotional) this sub-category belongs to.

default_preference'opt_in' | 'opt_out' | 'cant_unsubscribe'

Category-level default preference, inherited when the tenant has not overridden it.

default_mandatory_channelsstring[] nullable

Category-level mandatory channels (applies when the default preference is cant_unsubscribe).

default_opt_in_channelsstring[] nullable

Category-level opt-in channels, used when only selective channels are opted in by default.

enabled_for_tenantboolean

Whether the category is enabled for this tenant. When false, the category is hidden from the tenant's users and notifications are not sent in it.

visible_to_subscriberboolean

Whether the category appears on the tenant users' preference page.

preference'opt_in' | 'opt_out' | 'cant_unsubscribe' nullable

Tenant's overridden preference for this category. null if the tenant has not overridden the category default.

mandatory_channelsstring[] nullable

Channels the user cannot unsubscribe from (when preference is cant_unsubscribe), as overridden for this tenant.

opt_in_channelsstring[] nullable

Channels opted in by default for this category, as overridden for this tenant.

blocked_channelsstring[] nullable

Channels opted out across all categories for this tenant.

updated_atstring date-time nullable

Timestamp when the tenant preference for this category was last updated.