Retrieve all aliases linked to a user using a known subscription_id
. This is useful when the user’s identity is unknown but you have access to one of their push, email, or SMS subscriptions.
Use this API when you want to find the full identity (all aliases) of a user, starting from a known subscription_id
. This is helpful for debugging, reverse lookups, or support use cases where only a subscription record is available.
Unlike the View user identity API which starts with an alias (e.g., external_id
), this endpoint works when only a subscription ID is known.
See Subscriptions for background on how subscriptions relate to users.
To use this endpoint, you must provide:
subscription_id
– A UUID generated by OneSignal when a device or channel (e.g., push, email, SMS) is registered.subscription_id
values are immutable and cannot be changed. Make sure you are using the correct value, as they are unique to each app and platform.
Once a valid subscription_id
is provided, the API will return the user’s identity object, which includes all associated aliases like external_id
, onesignal_id
, and any custom aliases.
Your OneSignal App ID in UUID v4 format. See Keys & IDs.
The unique Subscription ID in UUID v4 format generated by OneSignal. See Subscriptions.
200
The response is of type object
.
Retrieve all aliases linked to a user using a known subscription_id
. This is useful when the user’s identity is unknown but you have access to one of their push, email, or SMS subscriptions.
Use this API when you want to find the full identity (all aliases) of a user, starting from a known subscription_id
. This is helpful for debugging, reverse lookups, or support use cases where only a subscription record is available.
Unlike the View user identity API which starts with an alias (e.g., external_id
), this endpoint works when only a subscription ID is known.
See Subscriptions for background on how subscriptions relate to users.
To use this endpoint, you must provide:
subscription_id
– A UUID generated by OneSignal when a device or channel (e.g., push, email, SMS) is registered.subscription_id
values are immutable and cannot be changed. Make sure you are using the correct value, as they are unique to each app and platform.
Once a valid subscription_id
is provided, the API will return the user’s identity object, which includes all associated aliases like external_id
, onesignal_id
, and any custom aliases.
Your OneSignal App ID in UUID v4 format. See Keys & IDs.
The unique Subscription ID in UUID v4 format generated by OneSignal. See Subscriptions.
200
The response is of type object
.