GET Profile Definition API

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.

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"
            }
        ]
    }

GET Data Layer Enrichment Public API

Was this page helpful?

This page was last updated: June 25, 2025