upgraded api decoded