Skip to content

List a person's interactions

GET
/audience/management/v1/individuals/{id}/interactions
curl --request GET \
--url 'https://api.ebitex.io/audience/management/v1/individuals/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/interactions?limit=50' \
--header 'Authorization: Bearer <token>'

Lists what has been recorded about a person, newest first, including those of anyone merged into them. Page with before, the occurredAtUtc of the last row you received, and limit (at most 100). This is a list: nothing here counts, groups or sums.

Key: an Audience management key with audience.management.read (write also needs read; erase needs both).

id
required
string format: uuid
before
string format: date-time
limit
integer | string format: int32
default: 50 /^-?(?:0|[1-9]\d*)$/

{ "items": [ { "id", "kind", "source", "sourceEventId", "occurredAtUtc", "recordedAtUtc", "data" } ], "next" }.

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired, or it was not created from the Audience settings page.

payment_required: the organization’s subscription needs attention.

scope_denied: the key lacks this route’s scope. ip_denied: the caller’s address is outside the key’s allowed ranges. app_not_available: Audience is not enabled for the organization.

individual_not_found: no such person in this organization.

not_found: no such route.

rate_limited: the key spent its requests-per-minute budget; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.