documentation udpates. get can return json as decoded