Get Audience Memberships

List audience members

GET/v1/audiences/{audienceId}/memberships

Use it in a workflow

Add a step and choose the Talon.One connector.
Pick the Get Audience Memberships action (under management).
Fill in the fields below, then reference the result from later steps as {{getAudienceMemberships.response.data}}.

Request

Path parameters

audienceIdinteger (int64)required

The ID of the audience.

Query parameters

pageSizeinteger (int64)

The number of items in the response.

Default 1000

skipinteger (int64)

The number of items to skip when paging through large result sets.

sortstring

The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations.

profileQuerystring

The filter to select a profile.

Response

Returns 200 with an object. Read it in later steps with {{getAudienceMemberships.response.data.<field>}}.

hasMoreboolean

dataarray<object>

idinteger (int64)required

The internal ID of the customer profile.

createdstring (date-time)required

The time this entity was created.

integrationIdstring (string)required

The integration ID set by your integration layer.

attributesobjectrequired

Arbitrary properties associated with this item.

accountIdinteger (int64)required

The ID of the Talon.One account that owns this profile.

closedSessionsinteger (int64)required

The total number of closed sessions. Does not include closed sessions that have been cancelled or reopened. See the [docs](https://docs.talon.one/docs/dev/concepts/entities/customer-sessions#customer-session-states).

totalSalesnumberrequired

The total amount of money spent by the customer **before** discounts are applied. The total sales amount excludes the following: - Cancelled or reopened sessions. - Returned items.

loyaltyMembershipsarray<object>2 fields

**DEPRECATED. Always returns `null`.** A list of loyalty programs joined by the customer.

audienceMembershipsarray<object>2 fields

The audiences the customer belongs to.

lastActivitystring (date-time)required

Timestamp of the most recent event received from this customer. This field is updated on calls that trigger the Rule Engine and that are not [dry requests](https://docs.talon.one/docs/dev/integration-api/dry-requests/#overlay). For example, [reserving a coupon](https://docs.talon.one/integration-api#tag/Coupons/operation/createCouponReservation) for a customer doesn't impact this field.

sandboxboolean

An indicator of whether the customer is part of a sandbox or live Application. See the [docs](https://docs.talon.one/docs/product/applications/overview#application-environments).

json

{
  "data": [
    {
      "accountId": 31,
      "closedSessions": 3,
      "created": {},
      "sandbox": false,
      "integrationId": "URNGV8294NV",
      "attributes": {
        "Language": "english",
        "ShippingCountry": "DE"
      },
      "totalSales": 299.99,
      "lastActivity": {},
      "id": 6,
      "loyaltyMemberships": [
        {
          "joined": {},
          "loyaltyProgramId": 323414846
        },
        {
          "joined": {},
          "loyaltyProgramId": 323414846
        }
      ],
      "audienceMemberships": [
        {
          "name": "Travel audience",
          "id": 2
        },
        {
          "name": "Travel audience",
          "id": 2
        }
      ]
    }
  ],
  "hasMore": false
}

Need more? See the Talon.One guide for connection setup and behaviour shared by every action.

Was this page helpful?