---
title: "Get user's namespaces or search namespaces"
method: GET
path: "/namespaces"
tags: ["namespaces"]
---

# Get user's namespaces or search namespaces

`GET /namespaces`

When called without query params, returns the authenticated user's namespaces (backwards compatible). When query params are provided, searches public namespaces with pagination. Use ownerId to filter by owner, hasServers/hasSkills to filter by content, q for text search.

## Query parameters

- `q` string
- `ownerId` string
- `hasServers` '0' | '1' | 'true' | 'false'
- `hasSkills` '0' | '1' | 'true' | 'false'
- `page` integer
- `pageSize` integer
- `fields` string

## Response `200`

Successful response

- NamespacesSearchResponse
  - `namespaces` NamespaceSearchResult[], required
    - `name` string, required
  - `pagination` object, required
    - `currentPage` integer, required
    - `pageSize` integer, required
    - `totalPages` integer, required
    - `totalCount` integer, required

## Other responses

- `401` — Unauthorized
- `500` — Server error

## Changes

- **2026-02-04** `0ea2d8e23fa1` — 1 breaking, 10 info
  - removed the required property `namespaces/items/createdAt` from the response with the `200` status
  - added the new optional `query` request parameter `fields`
  - added the new optional `query` request parameter `hasServers`
  - added the new optional `query` request parameter `hasSkills`
  - …7 more

[Change history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/namespaces/get.md)

---

[API](https://skmtc.dev/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smithery-ai/smithery-platform-api/revisions/60b8c3d2fecf/schema)