Find users API does not return suspended users and there is no way to retrieve accountId from these users to manage the lifecycle programmatically if the user is suspended.

Example: <site>.atlassian.net/rest/api/3/user/search?query=<user_display_name>

Can we add another query parameter to include suspended users in the find users API?

The only way to get suspended users is by calling 'Get all users' API but it does not have a query parameter and multiple calls are needed if you have 1k+ users.

At the Org level, there is an experimental API to restore/suspend users, but accountId is also needed and the 'Get users in the organization' API does not have a query parameter either.

Find users: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-user-search/#api-rest-api-3-user-search-get 

Suspended users: https://support.atlassian.com/user-management/docs/remove-or-suspend-a-user 

Get all users: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-users-search-get 

Org suspend users:  https://developer.atlassian.com/cloud/admin/organization/rest/api-group-directory/#api-v1-orgs-orgid-directory-users-accountid-suspend-access-post 

Org get users in the organization: https://developer.atlassian.com/cloud/admin/organization/rest/api-group-users/#api-v1-orgs-orgid-users-get