polished api document for json