---
title: "Search one unnamed task using the shopping index. Returns at most limit compact summaries (default 3); inspect the closest toolId first. Check match, category and alternatives; confident describes the task category, not certainty that a tool fits. Quality combines classified output, explicit ratings and a prior. Retain searchId for invoke. Use discover for a named provider or endpoint."
method: POST
path: "/v1/search_items"
---

# Search one unnamed task using the shopping index. Returns at most limit compact summaries (default 3); inspect the closest toolId first. Check match, category and alternatives; confident describes the task category, not certainty that a tool fits. Quality combines classified output, explicit ratings and a prior. Retain searchId for invoke. Use discover for a named provider or endpoint.

`POST /v1/search_items`

## Request

- Base URL: `http://localhost:5100`
- URL: `http://localhost:5100/v1/search_items`
- Auth: HTTP bearer

## Request body

- object
  - `request` string, required
  - `preference` number: 0 ranks by quality alone; higher values give price more weight, never more than quality. Defaults to 3.
  - `maxEffectivePriceMicros` string: Exclude items whose price per call is higher or unknown, in USD micros.
  - `limit` integer
  - `cardId` string, uuid: Card to use. Required when this connection has multiple cards. List cards first.

## Response `200`

Operation result. An invocation may still be pending; inspect its state.

- unknown

## Other responses

- `400`: Rejected request or temporary failure. See the errors and limits guide.
- `402`: Rejected request or temporary failure. See the errors and limits guide.
- `403`: Rejected request or temporary failure. See the errors and limits guide.
- `404`: Rejected request or temporary failure. See the errors and limits guide.
- `409`: Rejected request or temporary failure. See the errors and limits guide.
- `503`: Rejected request or temporary failure. See the errors and limits guide.

---

[API](https://skmtc.dev/o11/apis/o11-wallet-api.md) - [All operations](https://skmtc.dev/o11/apis/o11-wallet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/o11/apis/o11-wallet-api/revisions/2071972de71c?raw)