Get Users’ Subscription Groups
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:
Looking for the
As of May 2020, Braze has changed how we read API keys to be more secure. Now API keys must be passed as a request header, please see
YOUR_REST_API_KEY within the Example Request below.
Braze will continue to support the
api_key being passed through the request body and URL parameters, but will eventually be sunset. Please update your API calls accordingly.
||Yes||String||The external_id of the user (must include at least one and at most 50
|Yes*||String||The email address of the user (must include at least one address and at most 50 addresses).|
||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.|
||No||Integer||The limit on the maximum number of results returned. Default (and max) limit is 100.|
||No||Integer||Number of templates to skip before returning the rest of the templates that fit the search criteria.|
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
Example Request for SMS
1 2 curl --location --request GET 'https://rest.iad-01.braze.com/subscription/user/status?external_id=123456789&limit=100&offset=0&phone=+11112223334' \ --header 'Authorization: Bearer YOUR_REST_API_KEY'
Example Request for Email
1 2 curl --location --request GET 'https://firstname.lastname@example.org&limit=100&offset=0' \ --header 'Authorization: Bearer YOUR_REST_API_KEY'