USACE / USACE/cwms-data-api

Add username filtering for /users endpoint

Open
#1,515 1 comment 1 reaction 1 assignee View on GitHub

@rma-bryson is already working on this.

Since Feb 24, 2026.

enhancement
Dominant language
Java
Stars
28
Forks
25
Avg merge
4d 22h
Merged PRs (30d)
20

Description

Is your feature request related to a problem? Please describe.
Unless you already have a user's DoD Identification Number / EDI-PI, tracking down a user's account after initial creation is very tedious because you must manually sort through the full paginated response from the /users endpoint. The office parameter doesn't help because all users are under HQ by default.

Describe the solution you'd like
A query parameter such as username or like that allows wildcard-based filtering by username. This would allow searching by more easily-obtainable identifiers such as the user's first or last name. Could also be useful to allow filtering by roles per office (e.g. all users with CWMS Users in LRL) but this might be a little messier on the parameter-format side.

Describe alternatives you've considered
This could be a separate endpoint (e.g. /users/catalog), but seems like it fits under /users easily enough -- and feels more RESTful that way.

Additional context
n/a

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.