Catalog
The catalog is read-only over HTTP. A READ credential is enough.
Product groups vs products
Section titled “Product groups vs products”- A product group is a family of items in the catalog (brand, category, imagery, marketing name).
- Products under a group are the orderable variants. Cart lines always reference a product id (
products.id), not only the group.
So: group = shelf / family, product = the specific item you price and order.
Why delivery_country appears everywhere
Section titled “Why delivery_country appears everywhere”Catalog availability and pricing depend on ship-to country. Listing groups, listing products, and pricing all require (or strongly depend on) delivery_country so Fleet can apply the correct availability rules.
Filters on product groups
Section titled “Filters on product groups”You can filter product groups by category, brand, and text search. This is useful for storefront or internal picker UIs.
Pricing for one product
Section titled “Pricing for one product”The pricing endpoint returns commercial terms for one product: a principal amount plus shipping lead-time bounds (min_shipping, max_shipping). Values depend on delivery country and, when required, the selected keyboard_layout.
Keyboard layouts
Section titled “Keyboard layouts”When Fleet requires a keyboard choice, catalog responses expose allowed keyboard_layout values. Reuse those same values in cart lines and device payloads.
Next step
Section titled “Next step”In the sidebar, open API reference and use the Catalog tag for URLs, query matrices, and JSON examples.