documentation: added description with samples for API Endpoints