> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/products/cc-software/operate/command-centre-proximity-and-tracing-r.md).

# Proximity and Tracing Report

Generate proximity and contact tracing reports from Command Centre access events.

The Proximity and Contact Tracing Report Application is developed using the REST API, and the reports are output as `.csv` files, viewable in Microsoft Excel or similar.

The utility connects to Command Centre using the Gallagher **REST API connection parameters**. For more details, refer to the release note. The application is **not a licensed feature**, but it does use the REST API licences (**`RESTCardholder`** and **`RESTEvents`**).

## Parameters

The application provides a user interface that allows a user to enter the following parameters:

* The **origin cardholder**
* **From** and **To** dates
* **Maximum in-zone time**
* **Surface risk time**
* **Maximum contact generation**
* **Personal data fields**

## Frequently Asked Questions

### How do I get the Proximity and Contact Tracing Report utility?

Please liaise with your Gallagher representative about how to get this functionality.

### What Command Centre version does the Proximity and Contact Tracing Report utility support?

vEL7.90 or later.

### Is the Proximity and Contact Tracing Report a licensed feature?

No, the feature is not licensed; however, it uses the REST API licenses (RESTCardholder and RESTEvents). Customers without these licenses can place a $0 order for C12846 LIC Proximity and Contact Tracing Report and Gallagher will update their license. Once the license is updated, Gallagher will provide a link via which the Proximity and Contact Tracing Report feature can be downloaded.

### My license already has the RESTCardholder and RESTEvents licenses, how do I access the Proximity and Contact Tracing Report feature?

Customers that already have these licenses still need to place a $0 order for C12846 LIC Proximity and Contact Tracing Report and Gallagher will update their licenses. Once the license is updated, Gallagher will provide a link via which the Proximity and Contact Tracing Report feature can be downloaded.

### My license is updated, but I have not received a download link, who should I contact?

If you have not received a download link after your license was updated, please contact Gallagher customer service (via 0800 84 2273) and request a download link.

### What happens if I do not have exit readers at some areas of my site?

As the report is based on the events it will be able to report when an individual has entered the zone but it will not know when they have exited the zone. There is an option called "Maximum in-zone time" which can be configured so that the report will assume the individual has left a set number of hours after they have entered.

### What happens if people enter through a door without using their access credential?

This application analyses events generated by Command Centre on cardholder movements through doors. If an individual follows another person through a door without using their access credential they will not be identified in the report.

### Will the report recognize contact if cardholders enter through different doors configured with different access zones into the same physical area?

As the application analyses historical entry and exit events from an access zone, each access zone is treated as being a physical space. Doors that give access into a single physical space should be configured with the same access zone to ensure the reporting is as accurate as possible.

***

🔗 **Related**

* [Proximity and Contact Tracing Report](/knowledge-hub/products/integrations/reporting-and-notifications/proximity-and-contact-tracing-report.md). A worked configuration example for a real contact trace.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/products/cc-software/operate/command-centre-proximity-and-tracing-r.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
