Gundi FAQ

What is Gundi?

Gundi is a free, open-source platform built by EarthRanger together with WPS and WCS to make data sharing easier for conservation teams. It helps connect sensor data with conservation software so teams can access the information they need to make better, faster decisions.

Our goal is simple: connect technologies and people so conservation areas have reliable access to the data and insights they need to take effective action.

How can I integrate our technology with Gundi?

If you are a conservation practitioner who has acquired, or is considering acquiring, a specific technology for your work, we recommend reviewing our list of supported devices. If your technology is not listed, several integration options are available, depending on the capabilities of the relevant devices or services.

Quick Overview of Integration Options

  • Integrate via supported technologies*
  • Integrate via Webhooks (real-time data push).
  • Integrate via Gundi's API.
  • Integrate via scheduled data pulls using the manufacturer’s API.

* Note: This page covers Webhooks, Gundi’s API, and scheduled manufacturer API integrations. Supported technologies are documented separately in their respective guides.

I. Data Sources

a. Integration via Webhooks

  • If the data source supports webhooks, this is often the simplest integration method. 
  • Depending on the complexity and structure of the data, some integrations can be handled through configuration alone, while others may require coordination with our development team.
  • If this option interests you, please contact our team sharing the following information.

Information you can provide us

  • Technology Name
  • Technology Description
  • Desired Outcomes
  • Technical Contact (person able to configure the webhook)
  • Sample Data Payload (optional)
 
 

b. Integration via Gundi’s API

  • Our REST API gives the data source developer full control over how data is sent to Gundi and typically requires minimal coordination with our team. You can review our API documentation here.
  • If you are interested in this option, please share the following:

Information you can provide us

  • Technology Name
  • Technology Description
  • Desired Outcomes
  • Technical Contact (developer implementing the integration)
 
 

c. Integration via the Manufacturer’s API  

  • If your system cannot push data, and scheduled retrieval (e.g., every 5–30 minutes) is acceptable, our team can build a connector to pull data from your API. 
  • This option requires coordination with our development team. Timelines will depend on implementation complexity and team availability.
  • If you are interested in this option, please share:

Information you can provide us

  • Technology Name
  • Technology Description
  • Desired Outcomes
  • Technical Contact (person who can provide API documentation and access)
 
 

II. Data Destinations

a. Integration via your API

  • The process involves understanding your system, user requirements, and API.
  • If you are interested in this option, please share:

Information you can provide us

  • Technology Name
  • Technology Description
  • Desired Outcomes
  • Technical Contact (person who can provide API documentation)
  • Test credentials
 
 

How long does it take to integrate a device?

If the device is already included in our list of supported devices, integration is typically completed within one day or less.

For devices not yet supported, the timeline varies depending on complexity, data format, documentation quality, and vendor collaboration. In these cases, implementation can range from a few days to several months.

How does Gundi handle data privacy?

Gundi follows the EarthRanger sharing policy, which you can review here:

🔗 EarthRanger Privacy Policy

Additionally, users must review and accept Gundi's End User License Agreement (EULA):

🔗 Gundi User Agreement