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

# Search users

`GET /users/search`

Search users with optional filters, backed by Spanner

## Query parameters

- `email` string
- `name` string
- `id` string
- `limit` integer
- `cursor` string

## Response `200`

Users matching the search criteria

- UserSearchResult
  - `users` UserSearchReference[] — Users matching the search criteria
    - `id` string — The user ID
    - `email` string — The user's email address
    - `name` string — The user's full name
    - `given_name` string — The user's first/given name
    - `family_name` string — The user's surname
    - `created_by_id` string — ID of the user who created this user
    - `created_time` integer — Time at which the user was created
    - `last_updated_by_id` string — ID of the user who last updated this user
    - `last_updated_time` integer — Time at which the user was last updated
    - `type` 'agent' | 'normal' — Classification of the user. A null/unset value is equivalent to `normal` and is the default for existing users. `agent` users are synthetic users created to act on behalf of AI agent sessions that were initiated by an API key rather than a human user.
  - `cursor` string — Pagination cursor for the next page of results

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown error

---

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