BokaMera.API.Host

CompanyIncentiveQuery

**Requires Authentication**
Requires any of the roles:	bookingsupplier-administrator-write, bookingsupplier-administrator-read, superadmin

The following routes are available for this service:
GET	/companies/{CompanyId}/incentives	It gets either incentives which are not read or engaged by the current company/administrator.

**CompanyIncentiveQuery** Parameters:
Name	Parameter	Data Type	Required	Description
CompanyId	path	Guid?	Yes	The company id, if empty will use the company id for the user you are logged in with.

**CompanyIncentivesQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Incentives	form	IList<CompanyIncentiveResponse>	No
CompanyId	form	Guid	No

**CompanyIncentiveResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Heading	form	string	No
StorageUrl	form	string	No
SuccessButtonText	form	string	No
ActionId	form	int	No
InitialDelayInSeconds	form	int	No
MaxDisplayCount	form	int?	No
ValidFrom	form	DateTimeOffset	No
ValidTo	form	DateTimeOffset	No
Action	form	IncentiveActionResponse	No
Payload	form	string	No
Body	form	string	No
Frequency	form	IncentiveRecurrenceFrequency	Yes
InitialDeferredDays	form	int	Yes
RecurrenceInterval	form	uint	No
Active	form	bool	No
CompanyIds	form	List<Guid>	No
Criteria	form	List<IncentiveCriteriaDto>	No

**IncentiveActionResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Description	form	string	No
ActionType	form	IncentiveActionType	No
Page	form	string	No
Segment	form	string	No
Element	form	string	No
LicenseTypeId	form	int?	No
SuggestedLicenseToUpgrade	form	LicenseTypeQueryResponse	No

**IncentiveActionType** Enum:
Name	Value
Upgrade	1
AddOn	2
Information	3

**LicenseTypeQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The license type id
Name	form	string	No	The license type name
Description	form	string	No	The license type description
IsExtraLicenseOption	form	bool	No	If the license type is not a standard license but instead an extra license option. An example would be sending new letter license.
PeriodOfNoticeDays	form	int	No	The period of notice for the license in days.
Items	form	List<LicenseItemsResponse>	No	The license items for the license type
Prices	form	List<LicensePrice>	No	The license prices in each country for the license type

**LicenseItemsResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	No
AllowedItems	form	int	No

**LicensePrice** Parameters:
Name	Parameter	Data Type	Required
Country	form	Country	No
MonthlyPayment	form	bool	No
LicenseTypeId	form	int	Yes
CountryId	form	string	Yes
Price	form	int	Yes
ModifiedDate	form	DateTimeOffset?	No

**Country** Parameters:
Name	Parameter	Data Type	Required
CurrencyId	form	string	No
CurrencyInfo	form	Currency	No
Name	form	string	Yes
Culture	form	string	No
TimeZone	form	string	No
ModifiedDate	form	DateTimeOffset?	No
Id	form	string	Yes

**Currency** Parameters:
Name	Parameter	Data Type	Required
Name	form	string	Yes
CurrencySign	form	string	Yes
Active	form	bool	Yes
ModifiedDate	form	DateTimeOffset?	No
Id	form	string	Yes

**IncentiveRecurrenceFrequency** Enum:
Name	Value
OneTime	1
Weekly	2
Monthly	3

**IncentiveCriteriaDto** Parameters:
Name	Parameter	Data Type	Required
CriteriaType	form	CriteriaType	No
Value	form	string	No
InvertCondition	form	bool	No

**CriteriaType** Enum:
LicenseAvailability
SmsActivation
eAccountingActivation
CodeLockActivation
SocialActivation
OnlinePaymentActivation
FollowUpMessageActivation
RatingActivation

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 /companies/{CompanyId}/incentives HTTP/1.1 
Host: api.bookmore.com 
Accept: application/xml

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<CompanyIncentivesQueryResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
  <Incentives i:nil="true" />
</CompanyIncentivesQueryResponse>