For institutions and GBIF nodes
This page is for a national biodiversity system, a GBIF node, a park, a museum or a university team that wants to connect to Wildlife Network. It covers how to send data in, how to take data out, which licences we accept, how sensitive species are protected, and how credit works. Everything here is free and needs no agreement to start.
Sending data in
Pick the route that matches how your data is produced. All three use the open WDX format or a plain table.
1. Past surveys and field seasons: a contributed dataset
Upload a table of detections or observations (BirdNET, Kaleidoscope or any CSV) at /datasets/new. Names are matched to the GBIF backbone, records are checked for range, season and bursts, and the dataset gets its own page, citation and Darwin Core download. Signing in needs an ORCID iD, so each dataset is credited to a real person. For large or repeated loads, create an upload key on the dataset page and send rows from a script (up to 2,000 per request):
curl -X POST https://wlnw.org/api/v1/datasets/DATASET_ID \
-H "Authorization: Bearer YOUR_UPLOAD_KEY" -H "content-type: application/json" \
-d '{"action":"records","rows":[{"site":"Pond A","lat":-8.75,"lon":26.75,"ts":"2025-06-01T05:12:00Z","name":"Pycnonotus barbatus","confidence":0.92}]}'
curl -X POST https://wlnw.org/api/v1/datasets/DATASET_ID \
-H "Authorization: Bearer YOUR_UPLOAD_KEY" -H "content-type: application/json" -d '{"action":"submit"}'The same key also accepts WDX events with "action": "events". A key can add records, run the checks and submit that one dataset, nothing else.
2. A live system: push WDX events
If your system already produces detections as they happen, register a key for it and post WDX events (one event, an array or NDJSON, up to 5,000 per request). Keys are tied to one source system, so a key can only write that system's records.
curl -X POST https://wlnw.org/api/v1/register \
-H 'content-type: application/json' \
-d '{"name":"national-acoustic-network","source":"other"}'
curl -X POST https://wlnw.org/api/v1/events \
-H "Authorization: Bearer wn_YOUR_KEY" \
-H "content-type: application/x-ndjson" \
--data-binary @events.wdx.ndjsonField details are in the Developers and API page and the WDX schema.
3. Recorders in the field: the wdx-agent
For BirdNET-Pi, BirdNET-Go, camera traps (SpeciesNet), bat detectors (BatDetect2) or any software that writes a table, the free wdx-agent runs next to it, registers the station and sends new detections. Coordinates are rounded to about 1 km before they leave the device. Step by step: Contribute data.
Publishing to GBIF already? Records published to GBIF under CC0 or CC BY 4.0 reach Wildlife Network on their own, usually one to two weeks after GBIF receives them. There is no need to send them twice.
Taking data out
- Open data releases: weekly records, effort and arrival dates on a 5 degree grid, versioned on Zenodo with a DOI (10.5281/zenodo.23193453, always the newest). See Open data.
- API: JSON and CSV for arrivals, coverage, movement and open weekly records (
/api/v1/records). See the Developers and API page and OpenAPI file. - Contributed datasets: each dataset page has a Darwin Core CSV under the owner's licence, with positions rounded to the precision the owner chose.
- Places and parks: a site report shows what was recorded around a point for any dates, with a CSV of the open records.
BirdWeather detections power much of the live map with BirdWeather's agreement, but they are never in a download, a release or a bulk export.
Licences
- CC0 and CC BY 4.0: accepted for every route. These records count in every measure and may appear in open downloads, with credit.
- CC BY-NC 4.0: accepted for contributed datasets only. They count in the measures and are downloadable from the dataset's own page under that licence, but are left out of the open weekly records and the releases.
- Records pulled from GBIF and iNaturalist are limited to CC0 and CC BY.
Privacy and sensitive species
- Every measure works on 5 degree cells (about 550 km). Exact points are never needed to take part.
- The wdx-agent rounds station coordinates to about 1 km. Dataset owners choose the precision of their public download (1, 10, 25 or 50 km).
- Sensitive species on our published list are rounded to 1 degree in dataset downloads and are never named against a station in site reports. Tell us which species are sensitive in your country and we add them.
- Station owners and institutions can ask for a species, a station or a place to be hidden: email arunrajiah@gmail.com and it is done within two days.
- What the site itself collects about visitors is on the privacy page.
Credit
- Each contributed dataset has its own page and citation, and is named on the species pages and site reports that use it.
- GBIF records are credited by dataset, with DOIs, in the About panel and in every release (datasets.csv).
- Downloads carry a citation line. Releases have a CITATION.cff file and a DOI.
- Your data stays yours. Sending it here does not transfer any rights; you can withdraw a dataset or a station at any time.
Questions, or a national list of sensitive species to add? Email arunrajiah@gmail.com. Researchers: see also Research.