There are some well known api docs such as that of Stripe, Plaid, Twilio, etc. I believe there are some open source API docs too which can be used for inspiration.