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
catalog
enum<string>
default:public

Which catalog to search: "public" for the public price lists, or the caller organization's own catalog by contract vehicle. An organization without that catalog gets 404 naming the catalogs it has.

Available options:
public,
sewp-v,
sewp-vi
cursor
string

Opaque cursor from a previous response's meta.nextCursor. Omit for the first page.

perPage
integer
default:25

Results per page. Default 25, 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

Cursor pagination metadata for product catalog search. Results are relevance-ordered with a stable id tiebreaker, so following nextCursor neither repeats nor skips an item while the indexed results remain unchanged. Not CursorMeta, whose required count this endpoint does not emit.