Skip to main content
POST
Search product catalog items

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string

Search text over item description, manufacturer, and part numbers.

Maximum string length: 500
page
integer
default:1

1-based page number.

perPage
integer
default:20

Results per page. Default 20, maximum 100. Non-enterprise MCP access is capped at 50; REST access is Enterprise-only.

productCatalogIds
integer[]

Restrict to these catalog ids, from list_product_catalogs. Intersected with the catalogs the caller may access.

group
string

Exact filter on catalog group, a free-text bucket set at upload (for example "ESI" for the DoD Enterprise Software Initiative).

category
string

Exact filter on the item's product category.

manufacturer
string

Exact filter on the item's manufacturer name.

priceRange
number[]

Filter on contract price as [min, max]. Items with no contract price are excluded when this is set.

Required array length: 2 elements

Response

Matching catalog items

data
object[]
required
meta
object
required

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.