v1
latestOpenAPI 3.0.12026-07-245752052.0 MBtalent
Get audience history grouped by audience for a talent
Returns one entry per audience the talent has interacted with. Each entry includes the full event history trail (entered/exited with reasons), the linked campaigns (name, status, type), and a lastEventType denormalized from the most recent event. To scope results, filter on lastEventType via the standard filter syntax — e.g. filter[where][lastEventType][$in][]=entered (or exited, or both). The match runs after the audience-level grouping. Supported filter fields: lastEventType (string/$in), audienceName (regex), and relatedCampaigns.name (regex).
get/api/servicepool/talents/{identifier}/audienceHistory
Path parameters
identifierstring uuid required
talent unique identifier
Query parameters
{
"limit": 10,
"order": [
"prop DESC"
]
}Response
Successfully fetched audience history for a talent
Example response
{
"data": [
{
"audienceUuid": "123e4567-e89b-12d3-a456-426614174000",
"audienceName": "Nurses in LA",
"lastEventType": "entered",
"eventHistoryTrail": [
{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"companyUuid": "123e4567-e89b-12d3-a456-426614174000",
"talentUuid": "123e4567-e89b-12d3-a456-426614174000",
"audienceUuid": "123e4567-e89b-12d3-a456-426614174000",
"eventType": "entered",
"reason": "talent",
"occurredAt": "2025-09-09T10:58:17.451Z"
}
],
"relatedCampaigns": [
{
"audienceCampaignUuid": "123e4567-e89b-12d3-a456-426614174000",
"campaignType": "email",
"name": "Welcome campaign",
"status": "active"
}
]
}
],
"meta": {
"timestamp": "2021-05-05T09:47:58.924Z",
"verb": "GET",
"path": "/api/structure/resources/5949cf7c-fec6-4b31-947c-3aceabff58c5",
"jti": "%cQN3RIGp",
"rid": "$2d2zkHZ5",
"count": 1,
"status": "200",
"duration": 17,
"size": 1234
}
}