Problem Definition

Many API endpoints use the startat parameter to determine the index starting point, and then maxresults parameter to determine how many results will be returned. The groups endpoint instead users to [start:end] endpoint to determine which results will be returned.

For example, for users 50-100 it is:

• https://example.atlassian.net/rest/api/2/group?groupname=jira-users&expand=users[50:100]

Whereas you would expect

• https://example.atlassian.net/rest/api/2/group?groupname=jira-users&expand=users&startAt=50&maxResults=100

The inconsistent user experience makes it difficult to know which method to use.

Suggested Solution

Make all rest endpoints consistent in the way they handle startat and maxresults.

Workaround

The JIRA REST API typically specifies how it should be used, refer to the docs if you're not sure which to use.