further api explanations