Skip to content

Get tulo loyalty offers


Target audience: Developers

Release version: 3.9.1

Get Tulo loyalty offers


This endpoint returns Loyalty Offers from Tulo Loyalty Clubs within your organisation. Offers are filtered on whether they are active, and whether the current account has any loyalty products that gives access to an offer. Current account is the identity associated with the access-token being used. Please note that your organisation must have an active Loyalty Club integration to be able to use this endpoint. Please contact support if you have any questions about this.


Environment URI


Identity Scope
No /external/account/r


Name Type Description
account_id String The id of the account.

Curl Example

curl --request GET \
  --url \
  --header 'accept: application/json' \
  --header 'authorization: Bearer <token>'


Example response

HTTP 200
    "items": [
            "url": "",
            "name": "Name of offers",
            "subject": "Subject of offer",
            "text": "Some description of the offer, possible with embedded html-tags.",
            "validFrom": "2017-10-10T22:00:00Z",
            "validTo": "2017-12-10T22:59:59Z",
            "imageurl": "",
            "imageurls": [
            "zipcode": "",
            "city": "",
            "geocodingaddress": "",
            "geocodinglongitude": "",
            "geocodinglatitude": "",
            "ispremiumoffer": false,
            "interests": [


Example error response

HTTP 400 Bad Request
    "code": "unknown_parameter",
    "message": "No Tulo Loyalty Offers Integration enabled for Organisation"

HTTP 400 Bad Request

Name Type Description
configuration_error Object The Tulo Loyalty integration is not enabled for this account
unknown_parameter Object One or more parameters was not recognized

HTTP 404 Not Found

Name Type Description
not_found Object The account could not be found

HTTP 500 Internal Server Error

Name Type Description
internal_server_error Object Something unexpected happened server side