to make implementing this api as easy as possible, it might be nice to flatten the population field. 
(so instead add name and referenceVersion directly to the beaconRequest)

that way, a simple get request could be specified with just 5 url parameters