List all active products
Authorizations
Your Goody API key.
Query Parameters
Page for pagination, starting at 1
x > 1Items per page for pagination
1 < x < 100Limit to custom catalog only (for approved API partners)
Filter by a specific shipping country code
Show inactive products in the custom catalog. Only for Commerce API customers with a custom catalog.
Response
The price of shipping for this brand, in cents.
An array of brand values for this brand. Potential values are USA Made, Social Impact Driven, Sustainable, Gluten Free, Vegan, Kosher Certified, Female Founded, AAPI Founded, BIPOC Founded, Black Founded, LGBTQ+ Founded, and Hispanic Founded.
Whether this brand is excluded from the commerce revenue share. Only displayed on the products endpoint when using a commerce app.
When set and when the product price is above this amount, shipping is free. In cents. Products in a cart for this brand can combine to reach this threshold.
The price of the product, in cents.
Whether the price of this product is variable. If true, then the price can be set by the sender.
An array of attributes that describe this product.
The content for this attribute, e.g. "80% cotton, 20% elastane". This can be text or sanitized HTML (you might choose to sanitize the HTML as well). Allowed elements are a (href allowed), div, img (src, width height, alt allowed), span, p, br, strong, b, em, i, ol, ul, li, and hr.
The label for this attribute, e.g. "Materials".
The maximum price of the product, in cents. Only used if price_is_variable is true.
The minimum price of the product, in cents. Only used if price_is_variable is true.
An optional description of this product with custom verbiage for recipients. When provided, it overrides the subtitle for the product when displayed to the recipient. Falls back to the subtitle.
For approved API partners only.
For approved API partners only. A custom price tier for this product.
Whether this product is active. Since the product catalog only returns active products by default, this is always true, except if you are a Commerce API customer using a custom catalog, and are pulling products with the custom_catalog_show_inactive flag.
active, inactive A description of this product.
An optional one-line description of this product. When provided, it overrides the subtitle when displayed in areas with less space. Not always provided.
The date and time this product was last updated, ISO 8601 format. This is bumped when the product, brand, product variants, product attributes, or product images are updated.
For products that have multiple types of variants, such as both Color and Size, this array contains each group and the options for each group. All variant group permutations have a variant generated for them, constructed from the options in the order of the groups, separated by /, e.g. Medium / Black when the groups are Size and Color.
The name of the variant group, e.g. "Size" or "Color".
The name of the variant group option, e.g. "Small" for the "Size" variant group.
The hex color code for this option, e.g. "#000000", if any.
The label for the variants of this product, e.g. "Size" or "Color".
The number of variants that can be selected for this product. For example, if this is a t-shirt, then this would be 1, since you can only select one size. If this were a build-a-box of chocolates, this could be 3 if you could select 3 flavor variants.