Added addition documentation: API end point interaction

Added documentation around the primary micro-services API end point of interaction.