Improved documenation for api validation