blocksurvey-public-api-function