---
title: "Search users."
method: GET
path: "/users/search"
tags: ["User"]
---

# Search users.

`GET /users/search`

## Query parameters

- `role` 'Admin' | 'Teacher' | 'Student' | 'Observer'
- `email` string
- `page` integer
- `per_page` integer

## Response `200`

The list of user objects.

- object
  - `users` UserWithRoles[]
    - `id` integer
    - `full_name` string
    - `display_name` string
    - `email` string
    - `role_names` string[]
  - `meta` object
    - `current_page` integer
    - `last_page` integer
    - `total_count` integer

## Other responses

- `400` — Required parameter is missing.
- `401` — Authorization information is missing or invalid.
- `403` — If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.
- `422` — Invalid parameters.

---

[API](https://skmtc.net/instructure/apis/studio-public-api.md) · [All operations](https://skmtc.net/instructure/apis/studio-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instructure/studio-public-api/revisions/4838a5113869/schema)