VidiAccess is a modular solution enabling live occupancy management in physical spaces.

It uses virtual tripwires above each entrance and exit of a venue to count the people inside the venue and compare it to a maximum occupancy threshold.  The result is communicated to the public on a digital signage screen, and to the venue staff on their mobile phone or computer.

Connected digital screens can display a variety of visual information including but not limited to the following:

  • Maximum occupancy allowed

  • Current occupancy

  • Entry advice (for example, “Welcome” or “Please wait”)

  • Any additional information

  • Advertisements

The layout of the visual information displayed on the digital screen and the logic of its rotation is determined by the Digital Player connected to the Content Management System (CMS). Most available CMS these days allow the creation of highly dynamic and customizable digital content, which can be controlled or augmented with third-party data received via Application Programming Interfaces (API).

VidiAccess solution by Quividi provides an easy to use API to communicate current and maximum occupancy to any third-party application. This data can then be used by the Digital Player/CMS to update visuals, occupancy figures and entry advice displayed on the digital screen.

The logic of such communication is illustrated in the following diagram:


The Digital Player/CMS should be able to send an API request to the VidiAccess Hub application to enquire about the current occupancy status.

To do this, the player should send an HTTP GET request to the following API point:

http://<IP address>:8080/api/v1/instances

Here, ‘IP address’ is the address of the machine where the VidiAccess Hub application is installed (VidiAccess Control Unit). This may be the same machine where the Digital Player application is installed, in which case ‘localhost’ can be used instead of the IP address. The default port is 8080, although this may be changed to another port, depending on the installation specifics.

In response to such API request, VidiAccess Hub will provide an HTTP response with JSON payload, for example:


  "instances": [


      "gates": [


          "id": 1,

          "in": 10,

          "out": 30



          "id": 2,

          "in": 30,

          "out": 20



      "boxid": 52190,

      "name": "Box #52190",

      "host": "",

      "number": 0,

      "gate_type": "both",

      "status": "ok"



  "current": 40,

  "threshold": 50,

  "reset_time": { "hour": 23, "minute": 0 },

  "status": "ok"


In this response, the Digital Player can simply pick the three most important points:

  • “current” - an integer number indicating the current occupancy

  • “threshold” - an integer number indicating the maximum occupancy

  • “status” - a string indicating the occupancy status (“ok” - below threshold, “ko” - occupancy threshold reached).

This data can be requested by the Digital Player/CMS from the VidiAccess Hub application as frequently as needed, as it is updated in real time.

Please contact Quividi at if you need any assistance in setting the integration up. You can find the API manual here for more details