---
title: "Search the member directory"
method: GET
path: "/api/directory/search"
tags: ["directory"]
---

# Search the member directory

`GET /api/directory/search`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/directory/search`
- Auth: HTTP bearer

Clerk session or agt_ token with `directory:search`. Privacy-graded search over the member roster; the fields returned depend on the caller's tier.

## Query parameters

- `q` string
- `limit` integer

## Response `200`

Privacy-graded search results.

- DirectorySearchResponse: Privacy-graded results; the fields per member depend on the caller's tier.
  - `results` object[]
  - `count` integer
  - `query` string

## Other responses

- `401`: No auth.
- `403`: Scope not authorized.
- `500`: Search failed.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)