Skip to main content
POST
Search catalog products
Key: Read Scope: Company

Authorizations

Authorization
string
header
required

Use your Primo API key in the Authorization header as Bearer <API_KEY>.

Path Parameters

countryCode
string
required

Body

application/json

Substring match on the product NAME only (case-insensitive, not tokenized). Use it for a model name such as "ThinkPad" or "MacBook Air" — never for specifications, which it does not read: "16 GB business laptop" matches nothing.

types
enum<string>[]

Filter by product types (e.g. laptop, monitor)

Available options:
laptop,
tablet,
smartphone,
cable_adapter,
charger,
headset,
hub,
keyboard,
laptop_case,
monitor,
mouse,
other
brands
string[]

Filter by brand names

hasZTD
boolean

Only return products that support zero-touch deployment

hasStock
boolean

Only return products with at least one supplier holding stock in the requested country

specifications
object

Filter on the product specifications, keyed by specification name. ram, storage (GB amounts), screenSize (whole inches) and processor (BRAND|Family) are canonical: pass the exact values the catalog filter-options endpoint returns for them, a value matches every product whose stored specification maps to it. operatingSystem, resolution, position, color and the other keys are matched as a case-insensitive PREFIX of the stored free-text specification. keyboardLayout takes the layout codes the filter-options endpoint returns and matches products with a variant (or a product-level layout) sold in the country, in stock when hasStock is set. Values inside one key are OR-ed, different keys are AND-ed: {"ram":["16","32"],"operatingSystem":["Windows 11 Pro"]} returns 16 GB or 32 GB machines running Windows 11 Pro. There is no numeric comparison — express "at least 16 GB" by listing every option at or above 16.

page
integer
default:1
Required range: x <= 9007199254740991
take
integer
default:100
Required range: x <= 100

Response

default - application/json
total
integer
required

Total number of products matching the search

Required range: -9007199254740991 <= x <= 9007199254740991
data
object[]
required