---
title: "Get audience history grouped by audience for a talent"
method: GET
path: "/api/servicepool/talents/{identifier}/audienceHistory"
tags: ["talent"]
---

# Get audience history grouped by audience for a talent

`GET /api/servicepool/talents/{identifier}/audienceHistory`

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).

## Path parameters

- `identifier` string, uuid, required

## Query parameters

- `filter` ParametersFilter
  - `where` ParametersFilterWhere
  - `fields` ParametersFilterFields
  - `limit` number
  - `skip` number
  - `order` string[]
  - `collate` ParametersFilterCollation
    - `locale` string
    - `strength` number
    - `caseLevel` boolean
    - `numericOrdering` boolean

## Response `200`

Successfully fetched audience history for a talent

- object
  - `data` TalentAudienceHistoryByAudienceDto[], required
    - `audienceUuid` string, required — The unique identifier of the audience
    - `audienceName` string, required — The display name of the audience
    - `lastEventType` 'entered' | 'exited', required — Most recent event type for this (talent, audience) pair. Equivalent to `eventHistoryTrail[0].eventType` after the trail is sorted descending; denormalized for filtering.
    - `eventHistoryTrail` object[], required — Event history for the audience, ordered newest event first
      - `uuid` string, required — The unique identifier of the history record
      - `companyUuid` string, required — The unique identifier of the company
      - `talentUuid` string, required — The unique identifier of the talent
      - `audienceUuid` string, required — The unique identifier of the audience
      - `eventType` 'entered' | 'exited', required — Whether the talent entered or exited the audience
      - `reason` 'talent' | 'audience' | 'exclusionSetting', required — What triggered the event
      - `occurredAt` string, date-time, required — ISO timestamp when the event was emitted by the publisher
    - `relatedCampaigns` object[], required — Campaign summary rows linked to this audience
      - `audienceCampaignUuid` string, required — The unique identifier of the audience campaign
      - `campaignType` 'email' | 'sms', required — Campaign channel type
      - `name` string, required — Campaign display name
      - `status` 'active' | 'archived' | 'completed' | 'deleted' | 'draft' | 'scheduled' | 'queued', required — Campaign status
  - `meta` ResponsesPartMeta, required
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `status` string
    - `duration` number
    - `size` number

## Other responses

- `404` — default error response

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/revisions/5f406c0e9462/schema)