Get information about one category

GET /company/categories/@id

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 The ID of the category you want to return

Example request 1

GET /company/categories/14 HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 1.2.0
Accept-Language: en-US,en;q=0.5

Response

Field Type Description
name [Language: String] Translated category name
description [Language: String] Description of this category
active Bool A boolean value
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
products [company.Product.simple] Array of company.Product.simple
shops [company.Shop.simple] Array of company.Shop.simple
id Int ID of the category
banner Image? Nullable.
seo company.SeoData Optional. The category's webpage search engine metatags

Example response 1

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

{
    "name": "Vickie DuBuque",
    "description": {
        "nl": "...",
        "en": "...",
        "fr": "..."
    },
    "active": false,
    "only_order_in_store": false,
    "products": [
        {
            "name": {
                "nl": "...",
                "en": "...",
                "fr": "..."
            },
            "description": {
                "nl": "...",
                "en": "...",
                "fr": "..."
            },
            "specialty": true,
            "active": true,
            "only_order_in_store": false,
            "price_type": "PER_UNIT",
            "price": 12,
            "target_price": true,
            "url_type": "none",
            "url": "https://example.com",
            "min_max": {
                "amount": {
                    "minimum": 10,
                    "maximum": 18,
                    "maximum_day": 15,
                    "maximum_week": 18
                },
                "weight": {
                    "minimum": 13,
                    "maximum": 10,
                    "maximum_day": 13,
                    "maximum_week": 14,
                    "suggested": 13
                },
                "persons": {
                    "minimum": 17,
                    "maximum": 18
                }
            },
            "id": 10,
            "allergens": [
                {
                    "id": 13,
                    "name": "Peanut"
                },
                {
                    "id": 19,
                    "name": "Lactose"
                },
                {
                    "id": 13,
                    "name": "Fish"
                }
            ],
            "category_id": 12,
            "price_look_up_code": "...",
            "seo": {
                "title": {
                    "en": "Impedit dolorem numquam non quia eum et atque qui."
                },
                "description": {
                    "en": "Sint eaque autem quae ut quia laboriosam accusamus. Voluptatibus nemo sit dicta et et non est. Enim sunt praesentium a."
                },
                "url": {
                    "en": "http://torp.com/"
                }
            },
            "code": "..."
        },
        {
            "name": {
                "nl": "...",
                "en": "...",
                "fr": "..."
            },
            "description": {
                "nl": "...",
                "en": "...",
                "fr": "..."
            },
            "specialty": false,
            "active": false,
            "only_order_in_store": true,
            "price_type": "PER_UNIT",
            "price": 17,
            "target_price": false,
            "url_type": "none",
            "url": "https://example.com",
            "min_max": {
                "amount": {
                    "minimum": 18,
                    "maximum": 17,
                    "maximum_day": 12,
                    "maximum_week": 10
                },
                "weight": {
                    "minimum": 19,
                    "maximum": 19,
                    "maximum_day": 11,
                    "maximum_week": 16,
                    "suggested": 14
                },
                "persons": {
                    "minimum": 10,
                    "maximum": 19
                }
            },
            "id": 10,
            "allergens": [
                {
                    "id": 12,
                    "name": "Nuts"
                },
                {
                    "id": 14,
                    "name": "Milk"
                },
                {
                    "id": 12,
                    "name": "Egg"
                }
            ],
            "category_id": 12,
            "price_look_up_code": "...",
            "seo": {
                "title": {
                    "en": "Adipisci accusamus odio ut at nam saepe facilis."
                },
                "description": {
                    "en": "Quo quis cumque optio vitae incidunt. Rem non ex quo autem omnis. Tenetur harum velit sed eos voluptatem ea. Accusamus nobis molestiae sed deserunt nisi sunt molestiae qui."
                },
                "url": {
                    "en": "http://www.boehm.com/enim-rerum-animi-placeat-possimus-aut"
                }
            },
            "code": "..."
        },
        {
            "name": {
                "nl": "...",
                "en": "...",
                "fr": "..."
            },
            "description": {
                "nl": "...",
                "en": "...",
                "fr": "..."
            },
            "specialty": false,
            "active": true,
            "only_order_in_store": false,
            "price_type": "PER_UNIT",
            "price": 14,
            "target_price": true,
            "url_type": "none",
            "url": "https://example.com",
            "min_max": {
                "amount": {
                    "minimum": 15,
                    "maximum": 11,
                    "maximum_day": 19,
                    "maximum_week": 15
                },
                "weight": {
                    "minimum": 17,
                    "maximum": 19,
                    "maximum_day": 12,
                    "maximum_week": 14,
                    "suggested": 12
                },
                "persons": {
                    "minimum": 11,
                    "maximum": 12
                }
            },
            "id": 16,
            "allergens": [
                {
                    "id": 18,
                    "name": "Fish"
                },
                {
                    "id": 12,
                    "name": "Sulphite"
                },
                {
                    "id": 11,
                    "name": "Egg"
                }
            ],
            "category_id": 18,
            "price_look_up_code": "...",
            "seo": {
                "title": {
                    "en": "Necessitatibus velit odit similique in molestias cupiditate nihil expedita voluptas."
                },
                "description": {
                    "en": "Quod omnis enim commodi laudantium. Non recusandae voluptatem ipsum dicta. Aliquid suscipit ut consequatur voluptatem. Voluptates incidunt ut aut non dolore non."
                },
                "url": {
                    "en": "http://www.nader.biz/"
                }
            },
            "code": "..."
        }
    ],
    "shops": [
        {
            "name": "Lois Schultz",
            "active": false,
            "address": {
                "street": "Sint-Denijslaan",
                "nr": "96",
                "zipcode": "9000",
                "city": "Gent",
                "country": "BE",
                "position": {
                    "latitude": 1.54361,
                    "longitude": 0.45645
                }
            },
            "allow_comments": true,
            "allow_orders": false,
            "delivery_use_intervals": true,
            "id": 11,
            "avatar": {
                "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
                    }
                ],
                "white_background": false
            },
            "banner": {
                "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
                    }
                ],
                "white_background": false
            }
        },
        {
            "name": "Kitty Bosco Jr.",
            "active": false,
            "address": {
                "street": "Sint-Denijslaan",
                "nr": "96",
                "zipcode": "9000",
                "city": "Gent",
                "country": "BE",
                "position": {
                    "latitude": 1.54361,
                    "longitude": 0.45645
                }
            },
            "allow_comments": true,
            "allow_orders": true,
            "delivery_use_intervals": false,
            "id": 16,
            "avatar": {
                "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
                    }
                ],
                "white_background": true
            },
            "banner": {
                "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
                    }
                ],
                "white_background": true
            }
        },
        {
            "name": "Miss Maureen Denesik",
            "active": true,
            "address": {
                "street": "Sint-Denijslaan",
                "nr": "96",
                "zipcode": "9000",
                "city": "Gent",
                "country": "BE",
                "position": {
                    "latitude": 1.54361,
                    "longitude": 0.45645
                }
            },
            "allow_comments": false,
            "allow_orders": false,
            "delivery_use_intervals": true,
            "id": 10,
            "avatar": {
                "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
                    }
                ],
                "white_background": true
            },
            "banner": {
                "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
                    }
                ],
                "white_background": true
            }
        }
    ],
    "id": 12,
    "banner": {
        "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
            }
        ],
        "white_background": true
    },
    "seo": {
        "title": {
            "en": "Magnam dolore quaerat et sunt praesentium error."
        },
        "description": {
            "en": "Illo et consequatur facere. Maiores et nihil iste non. Cupiditate est ut rerum est placeat exercitationem beatae aut. Exercitationem molestiae rerum ratione."
        },
        "url": {
            "en": "http://hills.com/aut-id-optio-voluptas-qui-exercitationem"
        }
    }
}
Version update available Please adjust your integration to the latest stable version (1.9.0)
1.2.0 stable