One challenge with date based is that it can make your API seem old if it’s really stable. For example, see PagerDuty’s v1 events API: https://events.pagerduty

One challenge with date based is that it can make your API seem old if it’s really stable. For example, see PagerDuty’s v1 events API: https://events.pagerduty.com/generic/2010-04-15/create_event.json https://events.pagerduty.com/generic/2010-04-15/create_event... Customers there would sometimes ask if that API was still relevant given its date is 9+ years old. In Shopify’s case, where there are quarterly version bumps and deprecation over time, date based makes better sense.