Entitlement Pricing in Search

The Get Seller Account endpoint returns a field, imin:entitlementFilter. Use a Customer’s imin:entitlementFilter as a query parameter (entitlementFilter=<opaque token>) in Search in order to get pricing in the results that reflect the Customer’s entitlement.

An Example:

Request

https://search.imin.co/events-api/v2/event-series?mode=upcoming-sessions&geo[radial]=51.5074,-0.1278,1&entitlementFilter=WyJodHRwczov..

Response

In the imin:AggregateOffer of each item in the results, there will be a field activeEntitlement for those opportunities where an appropriate Entitlement exists.

This price therein should be presented to the Customer. If it includes "imin:indicativePrice": true, it should be marked as “indicative” to them (i.e. it may not be the exact price).

{
  "@context": [ /* ... */ ],
  "id": "https://search.imin.co/events-api/v2/event-series?mode=upcoming-sessions&geo[radial]=51.5074,-0.1278,1&entitlementFilter=WyJodHRwczovL2Etc2VsbGVyLmNvbSIsICJodHRwczovL21ldGEuaW1pbi5jby92Mi9nbG9iZXgtYnJva2VyL2VudGl0bGVtZW50cyM4ZGZiYWQ1NS1mZGI1LTQ0NzktODZhNC1iODczYjE4ZWNmZjEiLCB0cnVlXQo=",
  "type": "imin:RestrictedCollection",
  "imin:totalItems": 39,
  "view": { /* ... */ },
  "imin:item": [
    {
      "type": "EventSeries",
      "name": "Fun Climbing Session",
      "imin:aggregateOffer": {
        "type": "imin:AggregateOffer",
        "activeEntitlement": {
          "type": "AggregateOffer",
          "id": "https://imin.co/ns/offers/123456abc",
          "price": 6.8,
          "priceCurrency": "GBP",
          "imin:indicativePrice": true
        },
        "publicAdult": {
          "id": "https://acme-leisure.com/api/offers/abc123",
          "type": "AggregateOffer",
          "price": 12.5,
          "priceCurrency": "GBP",
          "imin:membershipRequired": false,
          "validFromBeforeStartDate": "P7D"
        },
        "publicJunior": {
          "id": "https://acme-leisure.com/api/offers/def456",
          "type": "AggregateOffer",
          "price": 7.5,
          "priceCurrency": "GBP",
          "imin:membershipRequired": false,
          "validFromBeforeStartDate": "P7D"
        }
      },
    },
    // ...
  ],
  // ...
}