first draft of bonus api completed.