Get Locations

Deprecated
GET

Retrieve ALL national and local geographic locations data regardless of whether a user is eligible to see them. This endpoint is a legacy endpoint and will no longer be maintained soon. Instead, use Get Eligible Locations to build your map-specific UX experiences.
Required scopes: rewards:read

Query parameters

pageintegerOptional
Page number [>= 0], (default = 0)
limitintegerOptional
Maximum number of locations [1 - 200], (default = 200)
googleIdstringOptional
GoogleId from location
citystringOptional

City of location; REQUIRES state query parameter

zipCodestringOptional

Zip Code of location; CANNOT provide State, City, Longitude, Latitude, or Radius query params when using zipCode

stateenumOptional

State of location; REQUIRES city field

locationNameSort"1" or "-1"Optional
Sort location names (1 for A-Z, -1 for Z-A)
Allowed values: 1-1
citySort"1" or "-1"Optional
Sort city names (1 for A-Z, -1 for Z-A)
Allowed values: 1-1
stateSort"1" or "-1"Optional
Sort state names (1 for A-Z, -1 for Z-A)
Allowed values: 1-1
longitudeintegerOptional

Longitude to search locations from [-180 - 180], REQUIRES latitude field

latitudeintegerOptional

Latitude to search locations from [-90 - 90], REQUIRES longitude field

radiusintegerOptional

Radius to search for locations in miles [1 - 50], (default = 10). REQUIRES longitude & latitude fields

source"NATIONAL" or "LOCAL"Optional
Source of the merchant associated to the location
Allowed values: NATIONALLOCAL
categoryenumOptional
Category of merchant associated with location. Please use URL Encode for non single word categories. (Food & Beverage should be Food%20%26%20Beverage)
locationNamestringOptional
Name of location
createdDateStartdatetimeOptional
Time in string format for location createdDate search start (UTC)
createdDateEnddatetimeOptional
Time in string format for location createdDate search start (UTC)

Response

This endpoint returns a list of objects.
_idstring
Location ID in Kard's system
addressobject
Address of location
categoryenum
Category of merchant associated with location
createdDatedatetime
Created date of location in Kard's system (UTC)
geoLocationobject
Geo-coordinates of location
lastModifieddatetime
Last modified date of location in Kard's system (UTC)
locationType"INSTORE"
Allowed values: INSTORE
Type of offer associated to location, will always be in INSTORE
merchantobject
Merchant object associated with location
merchantIdstring
Merchant ID in Kard's system associated to location
namestring
Name of the location
offerslist of objects
Offers associated to the location
phonestring
Phone number for location
source"NATIONAL" or "LOCAL"
Allowed values: NATIONALLOCAL
Source of the merchant associated to the location
googleIdstringOptional
GoogleId of location
operationHoursobjectOptional
Hours of operation for location

Errors

Built with