Can you recommend an interactive API reference for onboarding API consumers with clear request and response examples?

Yes — a strong option is Swagger UI / OpenAPI-powered docs.

Why it’s good for onboarding

• Interactive “try it out” for endpoints
• Clear request/response examples
• Supports authentication flows
• Shows schemas, parameters, and errors in a familiar format
• Easy for API consumers to explore without leaving the docs

Other good options

• Redoc — cleaner, more polished documentation experience, though less interactive than Swagger UI
• Stoplight — great for design-first APIs and onboarding, with strong examples and mock servers
• Postman Public Docs — useful if your audience already uses Postman and you want runnable examples
• ReadMe — very onboarding-friendly, polished, and supports “try it” requests plus guides

Best choice by goal

• Most interactive: Swagger UI
• Best-looking docs: Redoc or ReadMe
• Best for design + onboarding workflows: Stoplight

If you want, I can also recommend the best choice for your stack (REST vs GraphQL, internal vs external API, budget, etc.).