Skip to main content
GET
/
v1
/
tenant
/
{tenant_id}
/
preference
/
category
/
{category}
Get Tenant Preference Single Category
curl --request GET \
  --url https://hub.suprsend.com/v1/tenant/{tenant_id}/preference/category/{category}/ \
  --header 'Authorization: Bearer <token>'
{
  "name": "tests",
  "category": "tests",
  "description": "asdf",
  "tags": [
    "asdasdasdasderrfjfsdihdaisjaisljdaskjdlkasdlkasdkasdlkasldajsldkajsdaksdasd",
    "checktag"
  ],
  "effective_tags": [
    "asdasdasdasderrfjfsdihdaisjaisljdaskjdlkasdlkasdkasdlkasldajsldkajsdaksdasd",
    "checktag"
  ],
  "root_category": "system",
  "default_preference": "cant_unsubscribe",
  "default_mandatory_channels": null,
  "default_opt_in_channels": null,
  "enabled_for_tenant": true,
  "visible_to_subscriber": true,
  "preference": null,
  "mandatory_channels": null,
  "opt_in_channels": null,
  "blocked_channels": null,
  "updated_at": null
}

Authorizations

​
Authorization
string
header
required

Pass as Bearer <API_KEY>. Get API Key from SuprSend dashboard Developers -> API Keys section.

Path Parameters

​
tenant_id
string
required

unique identifier of the tenant you want to get preferences for

​
category
string
required

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

Query Parameters

​
locale
string

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

​
name
string
​
category
string
​
description
string | null
​
tags
string[] | null
​
effective_tags
string[] | null
​
root_category
enum<string>
Available options:
system,
transactional,
promotional
​
default_preference
enum<string>
Available options:
opt_in,
opt_out,
cant_unsubscribe
​
default_mandatory_channels
string[] | null
​
default_opt_in_channels
string[] | null
​
enabled_for_tenant
boolean
​
visible_to_subscriber
boolean
​
preference
enum<string> | null
Available options:
opt_in,
opt_out,
cant_unsubscribe
​
mandatory_channels
string[] | null
​
opt_in_channels
string[] | null
​
blocked_channels
string[] | null
​
updated_at
string<date-time> | null