Get Eligible Merchants

Retrieve national merchants data that a specified user has eligible national offers at. 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

referringPartnerUserIdstringRequired

Referring partner user ID from issuer that specifies user

Query parameters

pageintegerOptional

Page number [>= 0], (default = 0)

limitintegerOptional

Maximum number of merchants to be returned [1 - 200], (default = 200)

categoryenumOptional

Category of merchant. Please use URL Encode for non single word categories. (Food & Beverage should be Food%20%26%20Beverage)

Response

This endpoint returns a list of objects.

_idstring

Merchant ID in Kard's system

acceptedCardslist of enums

Allowed values: VISAMASTERCARDAMERICAN EXPRESSDISCOVER

Card types accepted by merchant

categoryenum

Category of merchant

createdDatedatetime

Created date of merchant in Kard's system (UTC)

descriptionstring

Merchant description - usually a blurb outlining more details about the merchant

lastModifieddatetime

Last modified date of merchant in Kard's system (UTC)

namestring

Merchant name

offerslist of objects

Offers associated to the merchant

source"NATIONAL" or "LOCAL"

Allowed values: NATIONALLOCAL

Merchant source

websiteURLstring

Merchant's URL website

imgUrlstringDeprecated

[Deprecated — Please use imgUrl on the offer object which contain attribution tokens]. Merchant image asset URL

bannerImgUrlstringOptionalDeprecated

[Deprecated — Please use bannerImgUrl on the offer object which contain attribution tokens]. Merchant banner image asset URL

Errors

1 curl -G https://rewards-api.getkard.com/rewards/merchant/user/{referringPartnerUserId} \ 2 -H "Authorization: Bearer <token>" \ 3 -d limit=1 \ 4 -d page=0

1 [ 2 { 3 "_id": "5e27318c9b346f00087fbb5c", 4 "name": "Some merchant", 5 "source": "NATIONAL", 6 "description": "N/A", 7 "imgUrl": "https://www.somemerchant.com/image.png", 8 "bannerImgUrl": "https://www.somemerchant.com/bannerImage.png", 9 "websiteURL": "https://www.somemerchant.com", 10 "acceptedCards": [ 11 "AMERICAN EXPRESS", 12 "MASTERCARD", 13 "VISA", 14 "DISCOVER" 15 ], 16 "type": "CARDLINKED", 17 "category": "Food & Beverage", 18 "createdDate": "2022-03-12T05:00:58.456Z", 19 "lastModified": "2022-03-12T05:00:58.456Z", 20 "offers": [ 21 { 22 "_id": "5e27318c9b346f00087fbb5b", 23 "name": "Some offer", 24 "merchantId": "5e27318c9b346f00087fbb5c", 25 "offerType": "INSTORE", 26 "isLocationSpecific": false, 27 "optInRequired": false, 28 "expirationDate": "2022-03-12T05:00:58.456Z", 29 "commissionType": "PERCENT", 30 "totalCommission": 9.5, 31 "issuersCommission": 3.5, 32 "usersCommission": 6, 33 "startDate": "2022-01-01T05:00:00Z", 34 "terms": "Not all cards are eligible and not all transactions can be monitored. For debit cards, run transaction as credit, do not use PIN. Offer valid from 12/19/2018. Maximum individual reward 250 dollars. The business may change or end the Offer at any time up to the point of purchase without notice.", 35 "createdDate": "2022-03-12T05:00:58.456Z", 36 "lastModified": "2022-03-12T05:00:58.456Z", 37 "minRewardAmount": 5, 38 "maxRewardAmount": 20, 39 "minTransactionAmount": 5, 40 "maxTransactionAmount": 20, 41 "redeemableOnce": true, 42 "isTargeted": true, 43 "imgUrl": "https://www.someoffer.com/image.png", 44 "bannerImgUrl": "https://www.someoffer.com/banner", 45 "merchantLocationIds": [ 46 "12abc45ef" 47 ] 48 } 49 ] 50 } 51 ]

1	curl -G https://rewards-api.getkard.com/rewards/merchant/user/{referringPartnerUserId} \
2	-H "Authorization: Bearer <token>" \
3	-d limit=1 \
4	-d page=0

1	[
2	{
3	"_id": "5e27318c9b346f00087fbb5c",
4	"name": "Some merchant",
5	"source": "NATIONAL",
6	"description": "N/A",
7	"imgUrl": "https://www.somemerchant.com/image.png",
8	"bannerImgUrl": "https://www.somemerchant.com/bannerImage.png",
9	"websiteURL": "https://www.somemerchant.com",
10	"acceptedCards": [
11	"AMERICAN EXPRESS",
12	"MASTERCARD",
13	"VISA",
14	"DISCOVER"
15	],
16	"type": "CARDLINKED",
17	"category": "Food & Beverage",
18	"createdDate": "2022-03-12T05:00:58.456Z",
19	"lastModified": "2022-03-12T05:00:58.456Z",
20	"offers": [
21	{
22	"_id": "5e27318c9b346f00087fbb5b",
23	"name": "Some offer",
24	"merchantId": "5e27318c9b346f00087fbb5c",
25	"offerType": "INSTORE",
26	"isLocationSpecific": false,
27	"optInRequired": false,
28	"expirationDate": "2022-03-12T05:00:58.456Z",
29	"commissionType": "PERCENT",
30	"totalCommission": 9.5,
31	"issuersCommission": 3.5,
32	"usersCommission": 6,
33	"startDate": "2022-01-01T05:00:00Z",
34	"terms": "Not all cards are eligible and not all transactions can be monitored. For debit cards, run transaction as credit, do not use PIN. Offer valid from 12/19/2018. Maximum individual reward 250 dollars. The business may change or end the Offer at any time up to the point of purchase without notice.",
35	"createdDate": "2022-03-12T05:00:58.456Z",
36	"lastModified": "2022-03-12T05:00:58.456Z",
37	"minRewardAmount": 5,
38	"maxRewardAmount": 20,
39	"minTransactionAmount": 5,
40	"maxTransactionAmount": 20,
41	"redeemableOnce": true,
42	"isTargeted": true,
43	"imgUrl": "https://www.someoffer.com/image.png",
44	"bannerImgUrl": "https://www.someoffer.com/banner",
45	"merchantLocationIds": [
46	"12abc45ef"
47	]
48	}
49	]
50	}
51	]