Richemont.Booster2.PublicApi

<back to all web services

GetCustomerPaginated

Requires Authentication
The following routes are available for this service:
GET/customer/{brand}/slimGet customers listGet slim list of customers paginated and sorted
GetCustomerPaginated Parameters:
NameParameterData TypeRequiredDescription
pagequeryintNoIndex of the result set returned
itemsqueryintNoSize of the result set returned
noCountqueryboolNoOmit precise record count - save on performance
sortByquerystringNoValues can be 'NameDESC', 'NameASC', 'RegASC', 'RegDESC'
SearchCustomer Parameters:
NameParameterData TypeRequiredDescription
brandformstringYesBrand
posCodesformList<string>YesPOS Legacy
searchKeyformstringNoSearch key could be: 'Name', 'Email', 'Phone' without prefix, 'BoosterCustomerId' OR 'SapCRMId'
phoneNumberformstringNoSearch by phone number - exact match
emailformstringNoSearch by email address - exact match
locationCountryIdsformList<string>NoValues can be 'it', 'en' etc.
clientSpendingFromformdouble?NoClient Spending From e.g. '100'
clientSpendingToformdouble?NoClient Spending To e.g. '50000'
creationDateFromformDateTime?NoCustomer Creation Date From e.g. '2022-01-01'
creationDateToformDateTime?NoCustomer Creation Date To e.g. '2023-11-01'
transactionDateFromformDateTime?NoTransaction Date From e.g. '2022-01-01'
transactionDateToformDateTime?NoTransaction Date To e.g. '2023-11-01'
canBeContactedByMaisonformbool?NoValues can be 'true' or 'false'
birthdateMonthsformList<int>NoValues can be 1 for 'January', 2 for 'February', 3 for 'March', 4 for 'April', 5 for 'May', 6 for 'June', 7 for 'July', 8 for 'August', 9 for 'September', 10 for 'October', 11 for 'November', 12 for 'December'
interestsformList<GetCustomerInterest>NoCustomer interest filter
hobbiesformList<GetCustomerHobby>NoCustomer hobby filter
productCollectionsformList<GetCustomerProductCollection>NoCustomer product collection filter
customerStatusformList<string>NoCustomer Status e.g. 'Prospect', 'Client'
boosterCustomerIdsformList<int>NoList of BoosterCustomerIds, e.g. 1234567,1231231,12323423
hasSapCrmErrorformbool?NoValues can be 'true' or 'false'
productCategoriesformList<ProductCategory>NoProduct Categories
saleRepresentativeEmailsformList<string>NoSale Reprentative Emails
GetCustomerInterest Parameters:
NameParameterData TypeRequiredDescription
interestformstringYesInterest description
sapInterestIdformstringYesSAP Interest ID, e.g. 'CA-1'
GetCustomerHobby Parameters:
NameParameterData TypeRequiredDescription
hobbyformstringNoHobby description
sapHobbyIdformstringNoSAP Hobby ID, e.g. 'ART'
GetCustomerProductCollection Parameters:
NameParameterData TypeRequiredDescription
productCollectionformstringYesProduct Collection description
sapProductCollectionIdformstringYesSAP ProductCollection ID, e.g. 'CA-1'
ProductCategory Parameters:
NameParameterData TypeRequiredDescription
brandCategoryIdformstringNoBrand Category ID
grandCategoryIdformstringYesGrand Category ID
masterCategoryIdformstringNoMaster Category ID
categoryIdformstringNoCategory ID
subCategoryIdformstringNoSub Category ID
GetCustomerPaginatedResponse Parameters:
NameParameterData TypeRequiredDescription
totalPagesformintYesTotal Pages
totalResultsformintYesTotal Results
pageformintYesIndex of the result set returned
itemsformintYesSize of the result set returned
elementsformIEnumerable<GetCustomerPaginatedElement>YesList of customers
GetCustomerPaginatedElement Parameters:
NameParameterData TypeRequiredDescription
boosterCustomerIdformintYesBooster Customer Id
firstNameformstringYesFirst name
middleNameformstringYesMiddle name
lastNameformstringYesLast name
firstNameNotLatinformstringYesFirst name Not Latin
lastNameNotLatinformstringYesLast name Not Latin
phoneformstringYesCustomer phone
countryPrefixformstringYesPhone Country Prefix
emailformstringYesCustomer email
dataSharingConsentformbool?YesData Sharing Consent
selloutTransactionCountformintYesSellout Transaction Count
elevateCustomerIdformstringNoElevate Customer ID
elevateConsentStatusformstringNoElevate Consent Status
countryIdformstringNoCustomer Country Id
registrationDateformDateTime?NoRegistration date
sapCrmErrorMessageformstringNoSap Crm Error Message

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /customer/{brand}/slim HTTP/1.1 
Host: dev-api-booster.richemont.com 
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetCustomerPaginatedResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Richemont.Booster2.PublicApi.CRM.ServiceModel">
  <elements i:nil="true" />
  <items>0</items>
  <page>0</page>
  <totalPages>0</totalPages>
  <totalResults>0</totalResults>
</GetCustomerPaginatedResponse>