---
title: "Search the management catalog"
method: POST
path: "/credits/catalog/search"
tags: ["Catalog"]
---

# Search the management catalog

`POST /credits/catalog/search`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/catalog/search`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Searches the built-in account-visible management catalog, including endpoints that are currently disabled. Enterprise-owned Custom APIs remain available through the catalog listing and detail routes but are not included in this static search index. Returns price-free display metadata, desired enablement, and current platform availability so a dashboard can help a person choose tools before enabling them. Always-on system routes are omitted; a tenant-toggleable Locus Travel route is included when available. This operation does not call a provider or burn credits.

## Request body

- object
  - `query` string, required: Trimmed natural-language capability, provider, or endpoint query.
  - `limit` integer

## Response `200`

Ranked management results

- ManagementCatalogSearchResponse
  - `success` unknown, required
  - `query` string, required
  - `count` integer, required
  - `results` ManagementCatalogSearchMatch[], required
    - `slug` string, required
    - `provider` string, required
    - `providerName` string, required
    - `endpoint` string, required
    - `title` string, required
    - `description` string, required
    - `category` string
    - `enabled` boolean, required: The account's desired enablement. This is separate from current platform availability.
    - `availability` 'available' | 'temporarily_unavailable' | 'unknown', required
    - `unavailableReason` 'delivery_breaker' | 'platform_pause' | 'null', nullable, required
  - `note` string: Present when no catalog endpoint matched.

## Other responses

- `400`: Body must contain only a valid query and optional limit
- `401`: Missing or invalid management credential
- `403`: The authenticated management credential lacks one or more required scopes
- `500`: Catalog search failed

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)