younifyd
Menu

List Customer Entitlements

List customer entitlements

GET/customers/{customer-id}/customer_entitlements

Use it in a workflow

  1. Add a step and choose the Chargebee connector.
  2. Pick the List Customer Entitlements action (under Chargebee API).
  3. Fill in the fields below, then reference the result from later steps as {{listCustomerEntitlements.response.data}}.

Request

Path parameters

customer-idstringrequired

Query parameters

limitinteger (int32)

<p class="mb-2">The number of features for which to return <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">customer_entitlement</code> objects.</p> <div class="alert alert-info"><p class="mb-2"><strong class="font-semibold">See also</strong> <a href="/docs/api/customer_entitlements">Pagination for List customer entitlements</a>.</p></div>

Default 10

offsetstring

<p class="mb-2">Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">offset</code> to the value of <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">next_offset</code> obtained in the previous iteration of the API call.</p>

consolidate_entitlementsboolean

<p class="mb-2">When set to <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">true</code> , the response returns a unified view of entitlement values for each feature across the customer. This includes entitlements assigned directly to the customer as well as those inherited from any of the customer&#x27;s subscriptions. In this mode, the <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">subscription_id</code> field is omitted from the response objects. The consolidated entitlement value is derived using the same logic described in the <a href="/docs/api/subscription_entitlements">Subscription Entitlements documentation</a> , based on the feature type.</p>

Default false

Headers

chargebee-request-origin-devicestring

The device from which the customer has made the request

chargebee-request-origin-userstring (email)

The email address of your customer/user. Use this when the email address has only ASCII characters.

chargebee-request-origin-user-encodedstring (email)

The Base64-encoded email address of your customer/user. Use this if the email address has UTF-8 characters. When this header is provided, the header chargebee-request-origin-user is ignored.

chargebee-request-origin-ipstring

The IP address of the customer where the request originated

chargebee-business-entity-idstring

If the site has multiple business entities, you can use this custom HTTP header to specify the business entity for which Chargebee should perform the operation.

Response

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

listarray<object>
customer_entitlementobjectrequired6 fields

<div class="api-description"><span featureId="cb-entitlements"></span><p class="mb-2">The <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">customer_entitlement</code> resource can be viewed as a subset of the <code><a href="/docs/api/subscription_entitlements">subscription_entitlement</a></code> resource enhanced with the customer&#x27;s ID. It is introduced to help <a href="/docs/api/customer_entitlements/list-customer-entitlements">retrieve</a> all subscription entitlements for a specific customer.</p></div>

next_offsetstring

<p class="mb-2">This attribute is returned only if more resources are present. To fetch the next set of resources use this value for the input parameter <code class="bg-gray-100 text-gray-800 font-medium border border-gray-300 rounded px-1.5 py-0.5 mx-1 text-sm font-mono whitespace-nowrap">offset</code>.</p>

json
{
  "list": null,
  "next_offset": null
}

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

List Customer Entitlements — Chargebee — Documentation