Parameters:

 ----------

badgeids - Default: empty array --> all badges

includeexpired - Default: false --> if true all users are returned, even if their badge is expired

includesuspended - Default: false --> if true include disabled users as well

Return value:

 -----------array of [

    struct{                

        badge struct [badge.id, badge.name, badge.status]                

        array of user [user.id,user.username,user.idnumber,user.suspended,badge_issued.dateissued,badge_issued.dateexpire]      

    }

    array of {         

        warnings struct [item, itemid, warningcode, message]      

    }

]