Refactor api for better readability

**Problem**
When working with services, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

The issue does not name files, tests, or an entry point. Start by locating the service API error-handling code and review how current errors are produced. Done means the scope is defined and service errors provide more descriptive messages, with the relevant behavior verified.

Written by the indexing model from the issue text.