GET Profile Definition API lets you retrieve audience and badge data from a Tealium profile.
How it works
The Data Layer Enrichment Public API returns audience and badge data using only IDs. To reference the names of badges in the visitor data, you can request profile data using the Profile Definition API.
This API is controlled by the data layer enrichment setting. If data layer enrichment is disabled, the API returns a 404 response. For more information, see Enable server-side Data Layer Enrichment.
The Profile Definition API returns badge and audience data associated with a Tealium profile and is not restricted to any specific user.
Use the following GET command to retrieve a profile definition:
GET https://visitor-service.tealiumiq.com/datacloudprofiledefinitions/{ACCOUNT}/{PROFILE}
Example request
curl https://visitor-service.tealiumiq.com/datacloudprofiledefinitions/myaccount/main/
Example response
{
"audiences" : [
{
"id" : "myaccount_main_101",
"name" : "Sample Audience"
}
],
"badges" : [
{
"id" : 5113,
"name" : "Cart abandoner"
},
{
"id" : 32,
"name" : "Unbadged"
},
{
"id" : 31,
"name" : "Frequent visitor"
},
{
"id" : 30,
"name" : "Fan"
}
]
}
This page was last updated: October 14, 2026