(v1) Search for a User

Search for a specific user by username, UUID, or email address.

Note: For fetching all users, /api/v1/usersynchronise is strongly preferred. Use this endpoint only when you need to look up a single specific user.

Omit all of username, uuid, and emailAddress to return all users (not recommended — use synchronise instead).

Pagination:

Pass pagination parameters as a nested object in the request body:

{
  "pagination": {
    "paginate": true,
    "cursor": "{{cursor}}"
  }
}

Omit cursor on the first page. Recommend 50–100 users per call — full-roster unpaginated calls cause performance issues.

Upcoming enforcement: A future AMS release will add server-side enforcement that rejects unpaginated requests on high-volume endpoints. Implement pagination now to avoid disruption when that ships.