Browse Profile Benefits

A GET to the /profiles/{profileId}/benefits endpoint allows your application to retrieve all Benefits records associated with a Profile.

Browse a profiles available benefits. Similar to Browse Profile Claimable Benefits however this will only showed Issued benefits against a profile.

Filtering Benefits

Omneo allows filter parameters to be appended to the request URL.
These filters allow developers to refine the results returned in the response.
This saves developers from filtering all results on their front end.

Filters are available on the following attributes:

'benefit_definition_id',
'expires_at',
'issued_at',
'meta',
'external_id',
'timezone',
'claimed_at',
'redeem_code_pos',
'redeem_code_online'

Let's imagine we only want to display benefits with the tag "demo"
We can append filter parameters to our original endpoint as below:
{{baseUrl}}/profiles/{profileId}/benefits?tags[]=demo
where ?tags[]=demo results in the API returning only eligible benefits, with a tag of "demo"

We can even go one step further an add advanced filters to identify specific attributes such as:
?filter[benefit_definition_id]=3

Multiple filters can be used by separating the requests with &
Search for multiple tags:
?tags[]=csv&tags[]=download
Multiple filters at once:
?filter[claimed_at]=2020-10-10&tags[]=download

Logical operators can also be used in filters:
?filter[expires_at][lte]=2020-10-01&filter[expires_at][gte]=2020-11-01&tags[]=download

OperatorDescription
neNot Equal !=
gtGreater Than >
gteGreater Than or Equal To >=
ltLess Than <
lteLess Than or Equal To <=
Language
Credentials
Header
URL