Troubleshooting Empty Results from FusionAuth User Search API

[wesley]

I'm trying to retrieve a list of all users stored in FusionAuth using the /api/user/search endpoint but keep getting empty results.
To troubleshoot, I tested the request in Postman, sending a POST request to /api/user/search with the following body:

{
  "search": {
    "queryString": "email@email.com"
  }
}

However, the response I receive is:

{
  "expandable": [],
  "total": 0,
  "users": []
}

Am I doing something wrong? Is there a better guide on how to format and send this request correctly?

[wesley]

Your request body looks correct for a basic search by email and should return a result if a user with that exact email address exists in your system.

1. Ensure You Are Using POST (or Use GET with Query Parameters)

• The /api/user/search endpoint supports both POST and GET, but they expect different input formats.

If using GET, you must provide query parameters, such as:

GET /api/user/search?ids=<user_id>

2. Searching for Partial Matches

If you want to find all users with a certain email domain, try using a wildcard search:

{
  "search": {
    "queryString": "*@email.com"
  }
}

3. Verify API Key Permissions

If you still get empty results, ensure that:

• Your API key has sufficient permissions to query user data.
• The user records exist in the database.

4. Further Reading on User Search

For more details on how to construct search queries, refer to:

• Elasticsearch Search in FusionAuth
• User Search with Elasticsearch