Get Eligible Offers
Retrieve national offers data that a specified user is eligible for. Call this endpoint to build out your targeted offers UX experience. Local merchants and offers details can be found by calling the Get Eligible Locations endpoint with the includeLocal
query parameter.
Required scopes: rewards:read
Path parameters
Headers
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
Page number [>= 0], (default = 0)
Maximum number of offers to be returned [1 - 200], (default = 200)
Type of offer (whether it is run online or in-store)
Category of merchant associated with offer. Please use URL Encode for non single word categories. (Food & Beverage should be Food%20%26%20Beverage)
True returns targeted offers, false returns targeted and non-targeted offers
Sort offer start dates chronologically (1 for ascending, -1 for descending)
Sort offer expiration dates chronologically (1 for ascending, -1 for descending)
Sort merchant names (1 for A-Z, -1 for Z-A)
Response
Type of commission on offer (% or a flat $)
Created date of offer in Kard’s system (UTC)
Expiration date of offer if applicable (UTC)
True returns targeted offers, false returns targeted and non-targeted offers
Last modified date in Kard’s system (UTC)
Type of offer (whether it is run online or in-store)
Beginning date of offer (UTC)