Get Reserved Customers

List customers that have this coupon reserved

GET/v1/coupon_reservations/customerprofiles/{couponValue}

Use it in a workflow

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

Request

Path parameters

couponValuestringrequired

The code of the coupon. **Important:** The coupon code requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `SUMMER25%OFF` as `SUMMER25%25OFF`.

Response

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

totalResultSizeinteger (int64)

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

{
  "totalResultSize": 1,
  "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
        }
      ]
    }
  ]
}

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

Was this page helpful?