Get all the products that belong to a category and filter the results

GET /company/categories/@id/products

Request

Authentication

This endpoint requires authentication.

Header Value
Authorization Set the value to Bearer + + access_token

URL parameters

Replace the @ keywords in the URL with their corresponding value.

A dictionary with fields

Field Type Description
id Int Return all products in the given category

Query string (URL)

Append the querystring with following properties to the URL.

A dictionary with fields

Field Type Description
updated_since Timestamp Optional. Only return products that were adjusted since the given time
price_look_up_code Int Optional. Return all products with the given PLU code. PLU codes are not unique in our system

Example request 1

GET /company/categories/11/products?updated_since=1657086142&price_look_up_code=10 HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 1.9.0
Accept-Language: en-US,en;q=0.5

Response

Array of company.Product.detailed: [company.Product.detailed]

company.Product.detailed

Field Type Description
name [Language: String] Name of the product
description [Language: String] Description of the product
specialty Bool Whether this product is a specialty. Specialties are also displayed in a separate category and are highlighted with a star icon.
active Bool Inactive products are not visible in the webshop
only_order_in_store Bool Whether this product can only get ordered in the store with a separate UI for the shop employees, and not in the public webshop.
price_type PriceType A product has a price type that defines the price calculations and the way consumers can order the product.
price UInt Price of the product (cents). Please note that this value is ignored when price_type is MULTIPLE_CHOICE.
target_price Bool Is true when it's not possible to provide an exact price of this product when ordering (e.g. not exact weight possible). This option might deactive online payments for orders with this product (shop settings).
url_type String String enumarion of 'none', 'recipe', 'website'
url URL? Nullable. An URL field starting with http:// or https://
min_max company.MinMaxSummary The allowed amounts a customer is allowed to order of a product for amount / weight / persons
images [Image] Array of Image
product_prices [company.ProductPrice] Array of company.ProductPrice
option_sets [company.OptionSet.simple] Array of company.OptionSet.simple
id Int Id of the product
allergens [Allergen]? Nullable. The allergens of this product. An empty array means no allergens. Null means no allergens specified (= can have allergens, ask in shop).
category_id Int The category ID of the product
price_look_up_code String? Nullable. A String value
code String? Nullable. A custom code. You can set this to your own code and use this field to map your products to Bakeronline products
seo company.SeoData Optional. Product page SEO metatags
origin [Language: String] Optional. Origin of the product
ingredients [Language: String]? Optional. Nullable. Ingredients that are in the product
temperature_type String? Optional. Nullable. The temperature type when in a latch
warranty_type String? Optional. Nullable. The type of warranty for this product
warranty_price UInt? Optional. Nullable. Price of the warranty (cents).
stock company.Stock Optional. The stock data for a product
daysavailable [Int] Optional. Array of Int
upfront company.ProductUpfront Optional. The upfront settings for a product
use_pickup_after Bool Optional. Can pickup after a certain time be done?
pickup_after Time? Optional. Nullable. Pickup of product after what time?
use_pickup_before Bool Optional. Should a product be picked up before a certain time?
pickup_before Time? Optional. Nullable. Pickup of product before what time?
related_products [Int] Optional. List of related products, with a maximum of 8

Example response 1

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 22822

[
    {
        "name": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "description": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "specialty": true,
        "active": false,
        "only_order_in_store": true,
        "price_type": "PER_UNIT",
        "price": 13,
        "target_price": true,
        "url_type": "none",
        "url": "https://example.com",
        "min_max": {
            "amount": {
                "minimum": 18,
                "maximum": 11,
                "maximum_day": 10,
                "maximum_week": 13
            },
            "weight": {
                "minimum": 14,
                "maximum": 13,
                "maximum_day": 18,
                "maximum_week": 18,
                "suggested": 10
            },
            "persons": {
                "minimum": 17,
                "maximum": 15
            }
        },
        "images": [
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 16,
                "white_background": false
            },
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 13,
                "white_background": false
            },
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 17,
                "white_background": false
            }
        ],
        "product_prices": [
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 19,
                "id": 16,
                "order": 15,
                "price_look_up_code": "...",
                "code": "..."
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 16,
                "id": 18,
                "order": 13,
                "price_look_up_code": "...",
                "code": "..."
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 17,
                "id": 18,
                "order": 15,
                "price_look_up_code": "...",
                "code": "..."
            }
        ],
        "option_sets": [
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": true,
                "id": 11,
                "code": "...",
                "multiple_choice": false,
                "choose_amount": true,
                "min_different_options": 12,
                "max_different_options": 15,
                "min_amount_options": 15,
                "max_amount_options": 11
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": true,
                "id": 12,
                "code": "...",
                "multiple_choice": false,
                "choose_amount": true,
                "min_different_options": 14,
                "max_different_options": 15,
                "min_amount_options": 14,
                "max_amount_options": 18
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": false,
                "id": 11,
                "code": "...",
                "multiple_choice": false,
                "choose_amount": false,
                "min_different_options": 14,
                "max_different_options": 11,
                "min_amount_options": 19,
                "max_amount_options": 10
            }
        ],
        "id": 15,
        "allergens": [
            {
                "id": 13,
                "name": "Nuts"
            },
            {
                "id": 11,
                "name": "Gluten"
            },
            {
                "id": 18,
                "name": "Peanut"
            }
        ],
        "category_id": 15,
        "price_look_up_code": "...",
        "code": "...",
        "seo": {
            "title": {
                "en": "Tempore rerum corrupti ut fugit molestiae ab quia."
            },
            "description": {
                "en": "Consequatur ipsa nulla eius vitae sunt. Minus nihil voluptas temporibus non. Eaque autem recusandae ipsum cupiditate. Ipsa quae architecto sapiente rerum."
            },
            "url": {
                "en": "http://bradtke.net/autem-iste-unde-omnis-ut"
            }
        },
        "origin": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "ingredients": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "temperature_type": "any",
        "warranty_type": "none",
        "warranty_price": 15,
        "stock": {
            "soldout": true,
            "amount": 12,
            "soldoutUntil": "2019-01-31 12:00"
        },
        "daysavailable": [
            18,
            12,
            12
        ],
        "upfront": {
            "upfront_use_default": true,
            "upfront_type": "days",
            "upfront_days": 14,
            "upfront_time": "12:00",
            "upfront_hours": 11,
            "upfront_minutes": 16
        },
        "use_pickup_after": true,
        "pickup_after": "12:00",
        "use_pickup_before": false,
        "pickup_before": "12:00",
        "related_products": [
            10,
            16,
            11
        ]
    },
    {
        "name": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "description": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "specialty": true,
        "active": true,
        "only_order_in_store": false,
        "price_type": "PER_UNIT",
        "price": 18,
        "target_price": true,
        "url_type": "none",
        "url": "https://example.com",
        "min_max": {
            "amount": {
                "minimum": 19,
                "maximum": 17,
                "maximum_day": 10,
                "maximum_week": 19
            },
            "weight": {
                "minimum": 16,
                "maximum": 12,
                "maximum_day": 14,
                "maximum_week": 16,
                "suggested": 14
            },
            "persons": {
                "minimum": 12,
                "maximum": 17
            }
        },
        "images": [
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 14,
                "white_background": false
            },
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 19,
                "white_background": true
            },
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 17,
                "white_background": true
            }
        ],
        "product_prices": [
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 15,
                "id": 13,
                "order": 12,
                "price_look_up_code": "...",
                "code": "..."
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 11,
                "id": 15,
                "order": 12,
                "price_look_up_code": "...",
                "code": "..."
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 12,
                "id": 19,
                "order": 19,
                "price_look_up_code": "...",
                "code": "..."
            }
        ],
        "option_sets": [
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": true,
                "id": 13,
                "code": "...",
                "multiple_choice": true,
                "choose_amount": false,
                "min_different_options": 11,
                "max_different_options": 19,
                "min_amount_options": 13,
                "max_amount_options": 16
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": false,
                "id": 16,
                "code": "...",
                "multiple_choice": true,
                "choose_amount": false,
                "min_different_options": 18,
                "max_different_options": 13,
                "min_amount_options": 13,
                "max_amount_options": 11
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": false,
                "id": 18,
                "code": "...",
                "multiple_choice": false,
                "choose_amount": true,
                "min_different_options": 16,
                "max_different_options": 12,
                "min_amount_options": 13,
                "max_amount_options": 10
            }
        ],
        "id": 17,
        "allergens": [
            {
                "id": 15,
                "name": "Lupine"
            },
            {
                "id": 19,
                "name": "Celery"
            },
            {
                "id": 15,
                "name": "Milk"
            }
        ],
        "category_id": 10,
        "price_look_up_code": "...",
        "code": "...",
        "seo": {
            "title": {
                "en": "Ipsam nesciunt temporibus nisi voluptatem exercitationem libero."
            },
            "description": {
                "en": "Vel non maiores sunt. Et sit sunt maiores ut error reprehenderit neque. Excepturi est quia odio. Minima quis molestiae amet sapiente itaque magni. Aspernatur occaecati dolore facilis et."
            },
            "url": {
                "en": "http://www.smith.com/vel-facilis-labore-expedita-quae-et-quis-eum-animi.html"
            }
        },
        "origin": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "ingredients": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "temperature_type": "any",
        "warranty_type": "none",
        "warranty_price": 10,
        "stock": {
            "soldout": true,
            "amount": 13,
            "soldoutUntil": "2019-01-31 12:00"
        },
        "daysavailable": [
            12,
            16,
            11
        ],
        "upfront": {
            "upfront_use_default": true,
            "upfront_type": "days",
            "upfront_days": 10,
            "upfront_time": "12:00",
            "upfront_hours": 10,
            "upfront_minutes": 14
        },
        "use_pickup_after": true,
        "pickup_after": "12:00",
        "use_pickup_before": false,
        "pickup_before": "12:00",
        "related_products": [
            18,
            16,
            12
        ]
    },
    {
        "name": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "description": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "specialty": true,
        "active": false,
        "only_order_in_store": false,
        "price_type": "PER_UNIT",
        "price": 14,
        "target_price": false,
        "url_type": "none",
        "url": "https://example.com",
        "min_max": {
            "amount": {
                "minimum": 18,
                "maximum": 15,
                "maximum_day": 16,
                "maximum_week": 16
            },
            "weight": {
                "minimum": 17,
                "maximum": 10,
                "maximum_day": 17,
                "maximum_week": 10,
                "suggested": 13
            },
            "persons": {
                "minimum": 13,
                "maximum": 11
            }
        },
        "images": [
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 15,
                "white_background": true
            },
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 10,
                "white_background": true
            },
            {
                "resolutions": [
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    },
                    {
                        "src": "https://example.com",
                        "width": 600,
                        "height": 350
                    }
                ],
                "file_id": 16,
                "white_background": false
            }
        ],
        "product_prices": [
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 11,
                "id": 16,
                "order": 18,
                "price_look_up_code": "...",
                "code": "..."
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 17,
                "id": 15,
                "order": 11,
                "price_look_up_code": "...",
                "code": "..."
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "price": 12,
                "id": 14,
                "order": 17,
                "price_look_up_code": "...",
                "code": "..."
            }
        ],
        "option_sets": [
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": true,
                "id": 13,
                "code": "...",
                "multiple_choice": false,
                "choose_amount": true,
                "min_different_options": 11,
                "max_different_options": 11,
                "min_amount_options": 12,
                "max_amount_options": 16
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": false,
                "id": 15,
                "code": "...",
                "multiple_choice": true,
                "choose_amount": true,
                "min_different_options": 13,
                "max_different_options": 10,
                "min_amount_options": 12,
                "max_amount_options": 19
            },
            {
                "name": {
                    "nl": "...",
                    "en": "...",
                    "fr": "..."
                },
                "allow_attachment": true,
                "id": 16,
                "code": "...",
                "multiple_choice": false,
                "choose_amount": false,
                "min_different_options": 19,
                "max_different_options": 18,
                "min_amount_options": 18,
                "max_amount_options": 18
            }
        ],
        "id": 18,
        "allergens": [
            {
                "id": 10,
                "name": "Lactose"
            },
            {
                "id": 16,
                "name": "Crustaceans"
            },
            {
                "id": 17,
                "name": "Lupine"
            }
        ],
        "category_id": 11,
        "price_look_up_code": "...",
        "code": "...",
        "seo": {
            "title": {
                "en": "Assumenda explicabo et totam laborum sint est accusantium impedit tenetur neque atque."
            },
            "description": {
                "en": "Perferendis nisi alias accusantium quo quas eveniet atque. Laborum autem nostrum non inventore inventore. Dolorum quia vel et laboriosam iusto. Facilis perferendis quod distinctio autem."
            },
            "url": {
                "en": "https://www.bechtelar.com/qui-quisquam-repudiandae-dolorem-quis-eos-quia"
            }
        },
        "origin": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "ingredients": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "temperature_type": "any",
        "warranty_type": "none",
        "warranty_price": 18,
        "stock": {
            "soldout": true,
            "amount": 13,
            "soldoutUntil": "2019-01-31 12:00"
        },
        "daysavailable": [
            12,
            13,
            19
        ],
        "upfront": {
            "upfront_use_default": false,
            "upfront_type": "days",
            "upfront_days": 13,
            "upfront_time": "12:00",
            "upfront_hours": 12,
            "upfront_minutes": 15
        },
        "use_pickup_after": true,
        "pickup_after": "12:00",
        "use_pickup_before": false,
        "pickup_before": "12:00",
        "related_products": [
            19,
            19,
            12
        ]
    }
]
1.9.0 stable