v0.2.0 v3 api functions