Skip to main content
We currently only support GET requests for pulling information into your own website or app. More endpoints will be coming in the future but if you require a custom endpoint please contact us.

​
Authentication

All API endpoints are authenticated using Bearer tokens. This Bearer token will be provided to you when you reach out to our support. To authenticate your requests, you need to include the Bearer token in the header of your request. 
{
  "Authorization": "Bearer YOUR_BEARER_TOKEN"
}

​
Base URL

The base URL for all API requests is https://services.engagementagents.com/.

​
Rate Limiting

We currently have a rate limit of 1000 requests per minute. If you exceed this limit, you will receive a 429 Too Many Requests response. If you require a higher rate limit, please contact us.

​
ISO Codes

In the responses, you will see that the headline, description and imageUrl fields are returned in multiple languages. Below you can find a table of our ISO codes and what languages they represent.
ISO CodeLanguage
enEnglish
esSpanish
frFrench
dnDanish
swSwedish
nrNorwegian
polPolish
deuGerman
ndlDutch
czCzech

​
Campaign Types

When querying Marketing Campaigns, you can filter the results by specific campaign types using the type query parameter. By default, if no type is provided, campaigns of all types will be returned. If you’re only interested in certain types, simply include one or more type parameters in your query. For example: 
/api/v1/campaigns?type=Sales&type=Events
Tip: URL encoding is handled automatically by most tools (such as Swagger UI, Postman, Mintlify). However, if manually crafting a URL, remember to encode special characters like a space (’ ’) as %20 and slashes (’ / ’) as %2F. For example, when selecting New Arrivals, the URL becomes:
/api/v1/campaigns?type=New%20Arrivals
Below is a list of the available campaign types and what they represent:
TypeDescription
SalesA marketing campaign that includes a direct incentive to purchase. Examples include percentage discounts, gift with purchase offers, multi-buy deals, and other promotional incentives.
EventsA marketing campaign promoting an in-store event. These may include experiences, workshops, meet-and-greets, or holiday-themed activities. Events may or may not include purchase incentives, depending on the specific case.
New ArrivalsA marketing campaign that highlights newly launched products or collections. These campaigns do not include any purchase incentives.
LoyaltyA marketing campaign that includes an incentive to purchase, but the incentive is exclusive to members of a loyalty program (e.g., member-only discounts, early access, or points-based rewards).