#39 functional spec for general RSR API