> ## Documentation Index > Fetch the complete documentation index at: https://docs.govly.com/llms.txt > Use this file to discover all available pages before exploring further. # Search product catalog items > Search line items across government contract price lists for negotiated pricing, part numbers, and availability, with the constrained public parameter set shared by MCP search_product_catalog. query is a fuzzy search over item descriptions, manufacturers, and part numbers; productCatalogIds, group, category, manufacturer, and priceRange are exact filters AND-combined with query. productCatalogIds is always intersected with the catalogs the caller may access, so inaccessible ids drop out rather than erroring. Results are relevance-ordered; there is no sort control. ## OpenAPI ````yaml /openapi/tools-v1.yaml post /api/tools/v1/product_catalogs/search openapi: 3.1.0 info: title: Govly Tools API (Alpha) version: 1.0.0-alpha description: > ALPHA / UNSTABLE: This API is still in active development. Endpoint behavior, request fields, response fields, error codes, and operation names may change before the Tools API is declared stable. REST-callable tool surface for agent and automation workflows. Agents are the primary consumer, but integrations can be built on this API. Responses are JSON for typed clients; MCP tools may render action results into text-oriented formats separately. servers: - url: https://app.govly.com security: - bearerApiKey: [] - headerApiKey: [] tags: - name: Opportunities description: Search, fetch, and inspect Govly opportunity records. - name: Awards description: Search and inspect awarded government contracts. - name: Contacts description: Search and inspect government points of contact. - name: Signals description: Search clustered procurement and market intelligence signals. - name: Places description: Resolve place names to canonical Govly Place ids. - name: Product Catalogs description: List government contract price lists and search their line items. - name: Workspaces description: Create, update, and inspect opportunity workspaces. - name: Workspace Members description: Add users and teams to workspaces. - name: Workspace Attachments description: List and upload workspace attachments. - name: Workspace Comments description: Post comments to workspaces. - name: Follows description: Follow opportunities and related workspace activity. - name: Saved Searches description: List saved opportunity searches and cached matches. - name: Documents description: >- Read document representations and request temporary original-file downloads. - name: Quote Submissions description: >- Inspect quote submission requirements, submit quotes, and poll submission status. - name: Inbox description: Read and triage the authenticated user's matched inbox items. paths: /api/tools/v1/product_catalogs/search: post: tags: - Product Catalogs summary: Search product catalog items description: > Search line items across government contract price lists for negotiated pricing, part numbers, and availability, with the constrained public parameter set shared by MCP search_product_catalog. query is a fuzzy search over item descriptions, manufacturers, and part numbers; productCatalogIds, group, category, manufacturer, and priceRange are exact filters AND-combined with query. productCatalogIds is always intersected with the catalogs the caller may access, so inaccessible ids drop out rather than erroring. Results are relevance-ordered; there is no sort control. operationId: search_product_catalog requestBody: required: false content: application/json: schema: type: object additionalProperties: false properties: query: type: string maxLength: 500 description: >- Search text over item description, manufacturer, and part numbers. page: type: integer default: 1 description: 1-based page number. perPage: type: integer default: 20 description: > Results per page. Default 20, maximum 100. Non-enterprise MCP access is capped at 50; REST access is Enterprise-only. productCatalogIds: type: array items: type: integer description: > Restrict to these catalog ids, from list_product_catalogs. Intersected with the catalogs the caller may access. group: type: string description: > Exact filter on catalog group, a free-text bucket set at upload (for example "ESI" for the DoD Enterprise Software Initiative). category: type: string description: Exact filter on the item's product category. manufacturer: type: string description: Exact filter on the item's manufacturer name. priceRange: type: array items: type: number minItems: 2 maxItems: 2 description: > Filter on contract price as [min, max]. Items with no contract price are excluded when this is set. responses: '200': description: Matching catalog items content: application/json: schema: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/ProductCatalogItem' meta: $ref: '#/components/schemas/ProductCatalogSearchMeta' '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' components: schemas: ProductCatalogItem: type: object description: One line item in a product catalog, with its negotiated pricing. required: - id properties: id: type: string itemIdentifier: type: string description: The catalog's own identifier for the item (CLIN, SKU, or similar). description: type: string manufacturer: type: string manufacturerPartNumber: type: string vendorPartNumber: type: string category: type: string subcategory: type: string contractNumber: type: string listPrice: type: number contractPrice: type: number description: The negotiated price, and the field priceRange filters on. discountPercentage: type: number productCatalog: type: object description: The catalog this item belongs to. properties: id: type: string name: type: string ProductCatalogSearchMeta: type: object description: > Page-based pagination metadata for product catalog search. Deliberately not CursorMeta — this endpoint is offset-paginated, so it emits page/totalPages rather than a nextCursor. Converging it is tracked separately. required: - totalCount - page - perPage - totalPages properties: totalCount: type: integer description: Total matching items (capped at 10,000 by the search engine). page: type: integer perPage: type: integer totalPages: type: integer ErrorEnvelope: type: object required: - errors properties: errors: type: array items: type: object required: - status - code - title - detail properties: status: type: string code: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string responses: Error: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: bearerApiKey: type: http scheme: bearer bearerFormat: API key headerApiKey: type: apiKey in: header name: X-API-KEY ````