These are good observations, thank you! > The first case would be preferred if the API is for e.g. general queries of companies in some region. The second case

These are good observations, thank you! > The first case would be preferred if the API is for e.g. general queries of companies in some region. The second case might be preferred if your API only deals with those specific companies and has a different structure for each one (for good reasons). At the moment, I don't know if we will expand to the second use case. Because scope is limited and data set is also limited (mostly contains generic data). I think in that case it might make sense to go with option 1 and eventually introduce v2 which covers option 2.