---
sourceDocument: Xanadu Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Analytics Hub UUIDs

# Analytics Hub UUIDs {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Every combination of breakdowns, elements, a time series aggregation, and a domain that
you specify for an indicator has a unique identifier (UUID). To write scripts or just to
understand how the Analytics Hub
works, you should understand how these UUIDs are constructed.  
In the Analytics Hub and the workspace KPI Details, you select an indicator and can specify it further by the following:

* Up to two levels of breakdown
* Element filter
* Up to two levels of breakdown element, including multiple elements per level (aggregate score)
* A time series aggregation
* Domain separation
{#analytics-hub-uuids__ul_x23_ckl_knb}

Each combination is represented by a so-called UUID. The UUID is concatenated from the sys_IDs
of the indicator and any of these specifiers, in the following order (note the semicolon before
the domain id):

`
`<indicator_sys_id>:<breakdown_sys_id>:<elements_filter_sys_id or element_sys_ids>:<lvl-2 breakdown_sys_id>:<lvl-2 elements_filter_sys_id or element_sys_ids>:<aggregate_sys_id>;<domain_sys_id>`
`

All specifiers other than indicator_sys_id are optional, with one
exception: If a breakdown_sys_id is specified, so must be at least one
element_sys_id. To specify a breakdown and not specify elements, for
example to get a list of all elements, the breakdown sys_id goes in a separate parameter. For an
example, see this [GET/now/pa/scorecards REST API
example](https://servicenow-prod.fluidtopics.net/nXp_VWs_Mhj1qsqMNu9M2w "These examples demonstrate how to perform a REST query using cURL commands, and show the data returned for each command. Each example builds upon the last, with later examples using the data returned by earlier examples."). To refer to those scores
that do not match any elements of the specified breakdown, the string `unmatched`
goes in place of an element_sys_id.

Targets, thresholds, and other Analytics Hub and KPI Details functions apply per UUID. In other words, they apply separately to each
unique combination of indicator, breakdowns, elements and element filters, time series
aggregation, and domain. The KPI Signals application also monitors each fully
specified indicator separately, per UUID.
**Related concepts**   

* [Integrate Performance Analytics](https://servicenow-prod.fluidtopics.net/5MJRAfuGs4cdyA94wBTLfQ "Integrate Performance Analytics with an external system to collect scores based on remote data or to expose Analytics Hub information.")
* [KPI Details](https://servicenow-prod.fluidtopics.net/_RPF11mI9kPiAo_qqB6qpw "KPI Details is an exploratory view of indicators, used for more detailed analysis. It lets you see trends, predictions, breakdowns, and associated records for a specific indicator. The KPI Details page enables you to delve into the information behind your key performance indicators.")