Get Users’ Subscription Groups
get
/subscription/user/status
Use the endpoints below to list and get the subscription groups of a certain user.
If you want to see examples or test this endpoint for Email Subscription Groups:
If you want to see examples or test this endpoint for SMS Subscription Groups:
Request Parameters
| Parameter | Required | Data Type | Description |
|---|---|---|---|
external_id |
Yes | String | The external_id of the user (must include at least one and at most 50 external_ids). |
email |
Yes* | String | The email address of the user, can be passed as an array of strings (must include at least one address and at most 50 addresses). |
phone |
Yes* | String | The phone number of the user (must include at least one phone number and at most 50 phone numbers). The recommendation is to provide this in the E.164 format. |
limit |
No | Integer | The limit on the maximum number of results returned. Default (and max) limit is 100. |
offset |
No | Integer | Number of templates to skip before returning the rest of the templates that fit the search criteria. |
tip:
If there are multiple users (multiple external ids) who share the same email address, all users will be returned as a separate user (even if they have the same email address or subscription group).
Example Request for multiple users
https://rest.iad-03.braze.com/subscription/user/status?external_id[]=1&external_id[]=2
Example Request for SMS
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/subscription/user/status?external_id={{external_id}}&limit=100&offset=1&phone=+11112223333' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Example Request for Email
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/subscription/user/status?external_id={{external_id}}&email=example@braze.com&limit=100&offset=1' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Edit this page on GitHub