---
title: Visitor Profile API objects
description: Visitors are returned as JSON objects.
url: https://docs.tealium.com/api/v3/visitor-profile/objects/
---
## Visitor fields

Visitors are returned as JSON objects that contain the following fields:

|Object Name| Type| Description|
|---| ---| ---|
|`live`| Boolean|  Set to `true` if the visitor is currently in a live session. |
|`visitor`| object|  The visitor object with sub-objects for each of the attribute data types: <ul><li>Visitor IDs: `secondary_ids : { }`</li><li> Numbers/Array of Numbers:<br> `"metrics" : { }`<br> `"metric_lists" : { }`</li><li>Strings/Array of Strings/Set of Strings: <br>`"properties" : { }`<br> `"property_lists" : { }`<br> `"property_sets" : { }`<br> `"audiences" : { }`</li><li>Booleans/Array of Booleans:<br> `"flags" : { }`<br> `"flag_lists" : { }`</li><li>Dates: `"dates" : { }`</li><li>Badges: `"badges" : { }`</li><li>Tallies: `"metric_sets" : { }`</li><li>Timeline: `"sequences" : { }`</li><li>Funnel: `"funnels" : { }`</li></ul>|

## Example response

```json
{"live": false,
    "visitor": {
        "metrics": {
            "Weeks since first visit": 0.14,
            "Total referred visits": 11,
            "Lifetime visit count": 12,
            "Average visit duration in minutes": 0.36,
            "Lifetime event count": 35,
            "Total time spent on site in minutes": 4.27,
            "Total direct visits": 1
        },
        "dates": {
            "Last visit": 1521217490000,
            "last_visit_start_ts": 1521217490000,
            "First visit": 1521134626000
        },
        "properties": {
            "Lifetime browser versions used (favorite)": "Chrome",
            "Lifetime browser types used (favorite)": "Chrome",
            "profile": "main",
            "Lifetime devices used (favorite)": "Mac desktop",
            "Lifetime platforms used (favorite)": "browser",
            "Last event URL": "http://www.tealium.com/",
            "account": "tealium",
            "Lifetime operating systems used (favorite)": "Mac OS X"
        },
        "flags": {
            "Returning visitor": true
        },
        "funnels": {
            "fake_funnel": {
                "completed": true,
                "fake_title": {
                    "timestamp": 1655303842639,
                    "snapshot": {
                        "fake_string": "fake_string",
                        "Average visits per week": 1.0
                    }
                }
            },
            "pii_funnel": {
                "completed": true,
                "step2": {
                    "timestamp": 1655303842639,
                    "snapshot": {
                        "pii_string": "Example string",
                        "First visit": 1655303836000,
                        "Last event URL": "http://172.16.3.15:8000/datacloudtest.html"
                    }
                },
                "step1": {
                    "timestamp": 1655303842639,
                    "snapshot": {
                        "pii_string": "Example string"
                    }
                }
            }
        },
        "sequences": {
            "fake_timeline": [
                {
                    "timestamp": 1655303842639,
                    "snapshot": {}
                },
                {
                    "timestamp": 1655303842642,
                    "snapshot": {}
                },
                {
                    "timestamp": 1655303842652,
                    "snapshot": {}
                },
                {
                    "timestamp": 1655303842654,
                    "snapshot": {}
                },
                {
                    "timestamp": 1655303842665,
                    "snapshot": {}
                }
            ]
        },
        "audiences": [
            "fake_visitors"
        ],
        "badges": ["Unbadged"],
        "metric_sets": {
            "Lifetime operating systems used": {
                "Mac OS X": 12
            },
            "Lifetime devices used": {
                "Mac desktop": 12
            },
            "Lifetime browser versions used": {
                "Chrome": 12
            },
            "Lifetime browser types used": {
                "Chrome": 12
            },
            "Lifetime platforms used": {
                "browser": 12
            }
        }
    }
}
```