---
title: "Permission-scoped search for the ⌘K command palette."
method: GET
path: "/internal/command-palette/search"
tags: ["Command Palette"]
---

# Permission-scoped search for the ⌘K command palette.

`GET /internal/command-palette/search`

Permission-scoped search for the ⌘K command palette.

## Query parameters

- `q` string, required — Search query
- `type` union — Filter to a single entity type. Unknown values are rejected at validation rather than silently returning [].
  - 'partner'
  - 'merchant'
  - 'payment-link'
  - 'payout'
  - 'transaction'
  - 'invoice'
- `limit` integer

## Response `200`

Success

- CommandPaletteSearchResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` object[], required
    - `type` string, required — Entity type, e.g. partner | merchant | payment-link | payout | transaction
    - `id` string, uuid, required
    - `title` string, required
    - `subtitle` string
    - `parent_title` string — Parent-entity label for breadcrumb display (e.g. partner name for a merchant).
    - `context` string — If present, the palette calls switchContext(context) before navigating, e.g. 'merchant:<id>'.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

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