add alarms api methods