reboot of the api
example output, array example
updated docs
updated test
array test
update refs
badges