API Methods

The Utiq API offers methods for on-demand access to various Utiq functionalities and data objects with a single call. The API is available as part of the Utiq loader script (utiqLoader.js) and can be accessed via the window.Utiq.API object. Specific methods are described below:

• addEventListener

• removeEventListener

• showConsentManager

• showConsentModal

• handleConsentChange

• revokeConsentWithPopup

• handleDataClear

• getUtiqConsentStatus

• getIdGraphEntry

• setLogLevel

• resetLoggingLevel

• setConfig

• getConfig

addEventListener

Register events to Utiq SDK, ensuring you can interact with it, regardless of which script gets loaded first, avoiding race conditioning issues.

Parameters:

• eventName

• eventHandler

Returns:

• none

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

// Store event handlers as variables
const eventHandler1 = ({ params } /*IF NEEDED*/) => {
  // Callback action for eventName1
};
const eventHandler2 = ({ params } /*IF NEEDED*/) => {
  // Callback action for eventName2
};

window.Utiq.queue.push(() => {
  // Add event listeners
  window.Utiq.API.addEventListener('eventName1', eventHandler1);
  window.Utiq.API.addEventListener('eventName2', eventHandler2);
});

removeEventListener

Un-register events to Utiq SDK.

Parameters:

• eventName

• eventHandler

Returns:

• none

Example usage:

window.Utiq.queue.push(() => {
  // Remove event listener eventName2
  window.Utiq.API.removeEventListener('eventName2', eventHandler2);
});

showConsentManager

Displays the Utiq Consent Manager overlay popup. This method operates with the default Utiq consent management setup. Find more details on the Utiq dedicated consent popup page.

Parameters:

• none

Returns:

• none

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  window.Utiq.API.showConsentManager()
});

showConsentModal

Displays the “Manage Utiq” modal. This method operates only for digital properties of v4.0 Utiq Privacy Requirements or higher.

Parameters:

• none

Returns:

• none

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  window.Utiq.API.showConsentModal()
});

handleConsentChange

Method used for handling custom CMP consent change by managing the consent cookie and dispatching proper events handled by the Utiq service. It should be used when there’s a need to change the consent status.

Parameters:

• isConsentGranted : boolean - when consent is granted set to true. Otherwise, if consent is rejected set to false.

Returns:

• none

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  window.Utiq.API.handleConsentChange(true)
});

revokeConsentWithPopup

Method used to revoke consent. The user sees a confirmation popup upon revocation completion. It should be used instead of the handleConsentChange method when the user should see a confirmation of the consent revocation.

Parameters:

• none

Returns:

• none

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  window.Utiq.API.revokeConsentWithPopup()
});

handleDataClear

Method used to handle clear of all Utiq-related data from the browser cache and memory. Data clear is done automatically when window.Utiq.API.handleConsentChange(false) is called, so this method does not have to be called manually within the Utiq flow.

Parameters:

• none

Returns:

• none

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  window.Utiq.API.handleDataClear()
});

getUtiqConsentStatus

Method used to get current Utiq consent status.

Parameters:

• none

Returns:

• boolean: true / false

• undefined - only if the Utiq service has not yet been initialized

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  const status = window.Utiq.API.getUtiqConsentStatus()
  // Do something with the status
});

getIdGraphEntry

Method used to get Utiq IDs and their attributes.

Parameters:

• entryName : string, comma-separated string, array, or array of strings as object - Name of the entry/ies that should be extracted from the ID graph. Accepted values are: mtid, atid, attrid, category, ttl, domain

category will return ‘mobile’ or ‘fixed’, to differentiate if Utiq IDs are generated based the mobile connection, or the fixed connection

Returns:

string, or array of strings, or array of objects type value

• value of a data entry

• “Entry key (string) parameter is missing”

• “No Utiq configuration set up”

• “No required IDC data present. Cannot extract the ID graph entry”

• “Could not find an entry for provided entry name: {entryKey}”

Example usage - asking for a single / latest identified connection:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  const value = window.Utiq.API.getIdGraphEntry('entryName')
  // Do something with the value
});

Example usage - asking for a multi-connection identification:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  const value = window.Utiq.API.getIdGraphEntry(['entryName'])
  // Do something with the value
});

[
    {
        "domain": "utiq.example.com",
        "category": "mobile",
        "cc": "EN",
        "atid": "jmQdZ12ovOPVoQCspEKSBqyg3axh0lp2zsVs68KU7jgZgLw0RNz3BmcxJsSovqiCFSlGGFYF6LXh5clORInkWw==-d693cai1jcgp3k8eig3g",
        "mtid": "mt1-3yMJmGUWM3WK1RVBjNYDXg",
        "ttl": "2026-05-10T13:03:22.705312Z"
    },
    {
        "domain": "utiq.example.com",
        "category": "fixed",
        "cc": "EN",
        "atid": "BtkG9NZBNEbucAoQPmD5ZTnApqbSOtBIwSsSrDQjRaPpqWbF7H0NAo0YAXD5MiPA9XE7s5SQoadjuj5mNUFqtA==-d693cai1jcgp3k8eig3g",
        "mtid": "mt2-CCOLszVDmLnMq6GbKvJDyQ",
        "ttl": "2026-05-10T13:03:22.705312Z"
    }
]

setLogLevel

This methods allows you to define desired logging level. The logging level, stored in utiq_logging_level cookie, remains enabled until reset using the resetLoggingLevel method, detailed below.

Parameters:

• logLevel : string - Level of desired logging. Accepted values are: silent, error, warn (default), info, verbose (including DEBUG and TRACK messages)

Returns:

• none

This method logs "[INFO] Logging level (<logLevel>) has been set" message, that indicates the logging level has been set successfully.

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  window.Utiq.API.setLogLevel('logLevel')
});

resetLoggingLevel

This method reverts to default error logging level and deletes utiq_logging_level cookie.

Parameters:

• none

Returns:

• none

This method logs "[INFO] Logging level has been reset to error level" message, that indicates the logging level has been set back to the default successfully.

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() => {
  window.Utiq.API.resetLoggingLevel()
});

setConfig

This methods allows you to set Utiq configurations with an API, adding to Utiq.config, while being able for different parties to work in parallel, without each one resetting the object itself.

Parameters:

• Any configuration attributes, as object, from the available here

Returns:

• none

Example usage:

window.Utiq ||= {};
window.Utiq.queue ||= [];

window.Utiq.queue.push(() =>
  window.Utiq.API.setConfig({
    customizationOptions: {
      buttons: {
        bodyColor: '#ff0066',
        textColor: '#000000',
        radius: 5
      }
    }
  })
);

getConfig

This methods will return you all current configuration attributes set in Utiq.config, either through the object itself, or with setConfig API.

Parameters:

• none

Returns:

• All set configuration attributes, as object, from the available here

Example usage:

window.Utiq.API.getConfig()