---
title: "Search for users enrolled in a course by name"
method: GET
path: "/v1/installs/{installSid}/courses/{courseSid}/users"
tags: ["Course"]
---

# Search for users enrolled in a course by name

`GET /v1/installs/{installSid}/courses/{courseSid}/users`

## Request

- Base URL: `https://api.smarterproctoring.com`
- URL: `https://api.smarterproctoring.com/v1/installs/{installSid}/courses/{courseSid}/users`
- Auth: API key in header `token`

## Path parameters

- `installSid` string, required: Unique SID of the application install. Pattern: `AI` + 32 hex chars.
- `courseSid` string, required: Unique SID of the course. Pattern: `CU` + 32 hex chars.

## Query parameters

- `search` string, required: Search term to match against first name or last name (case-insensitive, partial match). Use empty string to return all users.
- `offset` integer: Zero-based offset for pagination.
- `role` 'learner' | 'instructor': Filter results to a specific enrollment role. If omitted, all roles are returned.
- `limit` integer: Maximum number of results to return. Default 25, max 100.

## Response `default`

Successful

- string

## Changes

- **2026-07-21** `9a73a4e9185a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api-2/changes/v1/installs/:installSid/courses/:courseSid/users/get.md)

---

[API](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api-2.md) - [All operations](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api-2/revisions/7199a3921c9d?raw)