# Are there API functions related to the tag reference tool?

**URL:** <https://forum.inductiveautomation.com/t/are-there-api-functions-related-to-the-tag-reference-tool/93756>\
**Category:** Ignition\
**Created:** [July 25, 2024, 4:30pm UTC](https://forum.inductiveautomation.com/t/are-there-api-functions-related-to-the-tag-reference-tool/93756 "2024-07-25T16:30:07Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![Nathan\_Foster](https://avatars.discourse-cdn.com/v4/letter/n/ecd19e/32.png) [@Nathan\_Foster](https://forum.inductiveautomation.com/u/Nathan_Foster)\
**Post date:** [July 25, 2024, 4:30pm UTC](https://forum.inductiveautomation.com/t/are-there-api-functions-related-to-the-tag-reference-tool/93756/1 "2024-07-25T16:30:07Z")

</div>

Are there API functions (Python or Java) related to the tag reference tracker? In particular, getting the active subscriptions from a tag path. Would be useful for generating a tag report as part of a test suite I'm developing.

---

<div class="post-metadata">

**Author:** ![paul-griffith](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/paul-griffith/32/37249_2.png) [@paul-griffith](https://forum.inductiveautomation.com/u/paul-griffith)\
**Post date:** [July 25, 2024, 4:58pm UTC](https://forum.inductiveautomation.com/t/are-there-api-functions-related-to-the-tag-reference-tool/93756/2 "2024-07-25T16:58:41Z")

</div>

`GatewayTagProvider` has the entrypoints:

> **[GatewayTagProvider](https://files.inductiveautomation.com/sdk/javadoc/ignition81/8.1.42/com/inductiveautomation/ignition/gateway/tags/model/GatewayTagProvider.html#getTagReferences(com.inductiveautomation.ignition.common.tags.config.model.TagReferenceQuery))**
>
> declaration: package: com.inductiveautomation.ignition.gateway.tags.model, interface: GatewayTagProvider

You'll _potentially_ get a `GatewayTagProvider` via `gatewayContext.getTagManager().getTagProvider(providerName)`.

---

<div class="post-metadata">

**Author:** ![Nathan\_Foster](https://avatars.discourse-cdn.com/v4/letter/n/ecd19e/32.png) [@Nathan\_Foster](https://forum.inductiveautomation.com/u/Nathan_Foster)\
**Post date:** [July 25, 2024, 6:10pm UTC](https://forum.inductiveautomation.com/t/are-there-api-functions-related-to-the-tag-reference-tool/93756/3 "2024-07-25T18:10:00Z")

</div>

Thanks!

I'm having trouble finding the class com.inductiveautomation.ignition.common.tags.config.model.TagReferenceQuery in the API docs so I'm not exactly sure what I need to pass to the method.

---

<div class="post-metadata">

**Author:** ![paul-griffith](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/paul-griffith/32/37249_2.png) [@paul-griffith](https://forum.inductiveautomation.com/u/paul-griffith)\
**Post date:** [July 25, 2024, 6:30pm UTC](https://forum.inductiveautomation.com/t/are-there-api-functions-related-to-the-tag-reference-tool/93756/4 "2024-07-25T18:30:57Z")

</div>

`TagReferenceQuery` is a Kotlin data class (more or less equivalent to a Java record class) - there's some issue I forget about with our Javadoc generation and Kotlin classes, but it takes three constructor parameters:

```python
data class TagReferenceQuery (
    val path: TagPath,
    val activeSubscriptions: Boolean,
    val activeSince: Long = 0
)

```

In Java, `TagPath`, primitive `boolean`, and primitive `long`.
