> For the complete documentation index, see [llms.txt](https://docs.guardianservice.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guardianservice.app/technical-information/tenant-admins/tenant-operations/tenant-apis/return-users-for-tenant.md).

# Return Users for Tenant

## Return Tenant Users

<mark style="color:green;">`POST`</mark> `/tenants/{tenantId}/users`

Return users for Tenant. For Tenant Admin role only.

#### Path Parameters

| Name                                       | Type   | Description |
| ------------------------------------------ | ------ | ----------- |
| tenantID<mark style="color:red;">\*</mark> | String | Tenant ID   |

#### Request Body

| Name | Type   | Description   |
| ---- | ------ | ------------- |
|      | String | Users filters |

{% tabs %}
{% tab title="200: OK Successful Operation" %}

```javascript
{
content:
            application/json:
              schema:
                type: object
                properties:
                  totalCount:
                    type: number
                  tenant:
                    $ref: '#/components/schemas/Tenant'
                  users:
                    type: array
                    items:
                      $ref: '#/components/schemas/UserShort'
}
```

{% endtab %}

{% tab title="401: Unauthorized Unauthorized" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="403: Forbidden Forbidden" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="500: Internal Server Error Internal Server Error" %}

```javascript
{
   
content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'

}
```

{% endtab %}

{% tab title="422: Unprocessable Entity Invalid Tenant ID" %}

```javascript
{
content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'

}
```

{% endtab %}
{% endtabs %}