Get shop by id

GET /shops/@id

Request

URL parameters

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

A dictionary with fields

Field Type Description
id Int An integer value

Example request 1 Invalid shop id

GET /shops/9595561232659595 HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 1.5.0
Accept-Language: en-US,en;q=0.5

Example request 2 Valid shop id

GET /shops/3145 HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 1.5.0
Accept-Language: en-US,en;q=0.5

Example request 3 Include ISOP category for owner (authenticated)

GET /shops/3145 HTTP/1.1
Host: api.bakeronline.be
Authorization: Bearer ccc718d9e3ec8422d6db853ee380bf0ebcd024fffe7371628c30b84ec34402f6575cf93d5e7743b3e5d42b2cdd01b243b2df363ba34f4f2928cc4f43cfaae7fa2eff58b434b55cdee39f161f290c2aafa0520da117b27ee50a2912f9571b227600eef255
X-VERSION: 1.5.0
Accept-Language: en-US,en;q=0.5

Example request 4 Shop with offer

GET /shops/3149 HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 1.5.0
Accept-Language: en-US,en;q=0.5

Response

Field Type Description
id Int Id of the shop
name String Name of the shop (translated)
address Address.detailed An address
allow_comments Bool A boolean value
offers [Offer] Array of Offer
images [String: Image] Dictionary of Image with keys of type String
allow_orders Bool A boolean value
delivery_use_intervals Bool A boolean value
categories [Category.simple] Array of Category.simple
category_groups [CategoryGroup] List of category groups. The ids refer to a category in the categories field. Categories without a CategoryGroup should also get displayed.
hours [MethodHours] Information about the opening hours, delivery hours... for all available methods and machines
contact Contact Contact details of a shop
messages [Message] You are required to keep track of the messages the user saw. When you receive new messages, you should indicate this in the app with a bubble icon (e.g. red circle with number of new messages)
info [Message] Same as messages, but you shouldn't notify the user when this changes or is received for the first time
currency Currency 3 letter ISO 4217 currency name (string)

Example response 1 Invalid shop id

HTTP/1.1 404 Not Found
Content-Type: application/json; charset=utf-8
Content-Length: 65

{
    "code": "shop_not_found",
    "message": "Shop not found"
}

Example response 2 Valid shop id

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

{
    "id": 3145,
    "name": "Rise of the Buns",
    "address": {
        "street": "Van de Veldedreef",
        "nr": "32",
        "zipcode": "7941",
        "city": "Landen",
        "country": "BE",
        "position": {
            "latitude": 50.8503396,
            "longitude": 4.3517103
        }
    },
    "allow_comments": false,
    "currency": "EUR",
    "images": {
        "avatar": {
            "resolutions": [
                {
                    "src": "https://bakeronline.be/uploads/shop-avatars/3145/180x180/bakkerij-verheyen.jpg",
                    "width": 270,
                    "height": 180
                },
                {
                    "src": "https://bakeronline.be/uploads/shop-avatars/3145/360x360/bakkerij-verheyen.jpg",
                    "width": 427,
                    "height": 285
                }
            ]
        },
        "banner": {
            "resolutions": [
                {
                    "src": "https://bakeronline.be/uploads/banner/3145/1300x315/bakkerij-maris.jpg",
                    "width": 300,
                    "height": 300
                },
                {
                    "src": "https://bakeronline.be/uploads/banner/3145/900x250/bakkerij-maris.jpg",
                    "width": 300,
                    "height": 300
                }
            ]
        }
    },
    "allow_orders": true,
    "delivery_use_intervals": false,
    "categories": [
        {
            "id": 4158,
            "name": "Red",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4159,
            "name": "SandyBrown",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4160,
            "name": "SlateGray",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4161,
            "name": "DarkSlateBlue",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4162,
            "name": "DarkBlue",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        }
    ],
    "offers": [],
    "category_groups": [
        {
            "name": "",
            "category_ids": [
                4158
            ]
        },
        {
            "name": "",
            "category_ids": [
                4159
            ]
        },
        {
            "name": "",
            "category_ids": [
                4160
            ]
        },
        {
            "name": "",
            "category_ids": [
                4161
            ]
        }
    ],
    "hours": [
        {
            "name": "6572",
            "description": null,
            "type": "open",
            "hours": [
                {
                    "days": "2125",
                    "times": [
                        "06:45 - 11:45",
                        "14:00 - 14:30"
                    ]
                },
                {
                    "days": "2126",
                    "times": [
                        "2035"
                    ]
                },
                {
                    "days": "2127",
                    "times": [
                        "08:45 - 10:00",
                        "10:30 - 11:00",
                        "11:45 - 12:15",
                        "12:15 - 13:15",
                        "13:45 - 14:15",
                        "15:00 - 15:45"
                    ]
                },
                {
                    "days": "2128",
                    "times": [
                        "09:30 - 10:15",
                        "11:15 - 12:00",
                        "12:00 - 13:45",
                        "09:30 - 10:15",
                        "11:15 - 12:00",
                        "12:00 - 13:45"
                    ]
                },
                {
                    "days": "2129",
                    "times": [
                        "2035"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "09:30 - 10:15",
                        "11:15 - 12:00",
                        "12:00 - 13:45"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "10:15 - 12:45",
                        "12:45 - 13:30",
                        "14:00 - 14:30",
                        "15:15 - 16:00"
                    ]
                }
            ]
        },
        {
            "name": "6573",
            "description": null,
            "type": "takeout",
            "hours": [
                {
                    "days": "2125",
                    "times": [
                        "3507"
                    ]
                },
                {
                    "days": "2126",
                    "times": [
                        "06:15 - 07:30",
                        "10:00 - 12:45",
                        "3841"
                    ]
                },
                {
                    "days": "2127",
                    "times": [
                        "08:30 - 09:30",
                        "14:30 - 15:45",
                        "3841"
                    ]
                },
                {
                    "days": "2128",
                    "times": [
                        "12:00 - 13:15",
                        "13:45 - 14:15",
                        "14:15 - 14:45",
                        "14:45 - 15:00",
                        "15:15 - 15:45",
                        "16:00 - 16:45",
                        "12:00 - 13:15",
                        "13:45 - 14:15",
                        "14:15 - 14:45",
                        "14:45 - 15:00",
                        "15:15 - 15:45",
                        "16:00 - 16:45",
                        "3841"
                    ]
                },
                {
                    "days": "2129",
                    "times": [
                        "12:00 - 13:15",
                        "13:45 - 14:15",
                        "14:15 - 14:45",
                        "14:45 - 15:00",
                        "15:15 - 15:45",
                        "16:00 - 16:45",
                        "3841"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "10:00 - 11:15",
                        "11:30 - 12:45",
                        "12:45 - 13:00",
                        "14:30 - 14:45",
                        "15:15 - 15:45",
                        "16:00 - 16:15",
                        "10:00 - 11:15",
                        "11:30 - 12:45",
                        "12:45 - 13:00",
                        "14:30 - 14:45",
                        "15:15 - 15:45",
                        "16:00 - 16:15",
                        "3841"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "10:00 - 11:15",
                        "11:30 - 12:45",
                        "12:45 - 13:00",
                        "14:30 - 14:45",
                        "15:15 - 15:45",
                        "16:00 - 16:15",
                        "3841"
                    ]
                }
            ]
        },
        {
            "name": "6574",
            "description": null,
            "type": "delivery",
            "hours": [
                {
                    "days": "2118 - 2119",
                    "times": [
                        "3507"
                    ]
                },
                {
                    "days": "2127",
                    "times": [
                        "09:00 - 13:00",
                        "09:00 - 13:00",
                        "09:00 - 13:00",
                        "3841"
                    ]
                },
                {
                    "days": "2121 - 2122",
                    "times": [
                        "09:00 - 13:00",
                        "3841"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "3507"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "10:15 - 10:30",
                        "11:45 - 12:30",
                        "12:45 - 13:00",
                        "14:45 - 15:45",
                        "16:15 - 17:00",
                        "3841"
                    ]
                }
            ]
        }
    ],
    "contact": {
        "address": {
            "street": "Van de Veldedreef",
            "nr": "32",
            "zipcode": "7941",
            "city": "Landen",
            "country": "BE"
        },
        "telephone": "+32 479 44 77 88",
        "vat": "BE 0335606977",
        "social": {},
        "website": null,
        "email": "wtimmermans@example.com"
    },
    "messages": [],
    "info": []
}

Example response 3 Include ISOP category for owner (authenticated)

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

{
    "id": 3145,
    "name": "Rise of the Buns",
    "address": {
        "street": "Van de Veldedreef",
        "nr": "32",
        "zipcode": "7941",
        "city": "Landen",
        "country": "BE",
        "position": {
            "latitude": 50.8503396,
            "longitude": 4.3517103
        }
    },
    "allow_comments": false,
    "currency": "EUR",
    "images": {
        "avatar": {
            "resolutions": [
                {
                    "src": "https://bakeronline.be/uploads/shop-avatars/3145/180x180/bakkerij-verheyen.jpg",
                    "width": 270,
                    "height": 180
                },
                {
                    "src": "https://bakeronline.be/uploads/shop-avatars/3145/360x360/bakkerij-verheyen.jpg",
                    "width": 427,
                    "height": 285
                }
            ]
        },
        "banner": {
            "resolutions": [
                {
                    "src": "https://bakeronline.be/uploads/banner/3145/1300x315/bakkerij-maris.jpg",
                    "width": 300,
                    "height": 300
                },
                {
                    "src": "https://bakeronline.be/uploads/banner/3145/900x250/bakkerij-maris.jpg",
                    "width": 300,
                    "height": 300
                }
            ]
        }
    },
    "allow_orders": true,
    "delivery_use_intervals": false,
    "categories": [
        {
            "id": 4158,
            "name": "Red",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4159,
            "name": "SandyBrown",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4160,
            "name": "SlateGray",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4161,
            "name": "DarkSlateBlue",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4162,
            "name": "DarkBlue",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        }
    ],
    "offers": [],
    "category_groups": [
        {
            "name": "",
            "category_ids": [
                4158
            ]
        },
        {
            "name": "",
            "category_ids": [
                4159
            ]
        },
        {
            "name": "",
            "category_ids": [
                4160
            ]
        },
        {
            "name": "",
            "category_ids": [
                4161
            ]
        }
    ],
    "hours": [
        {
            "name": "6572",
            "description": null,
            "type": "open",
            "hours": [
                {
                    "days": "2125",
                    "times": [
                        "06:45 - 11:45",
                        "14:00 - 14:30"
                    ]
                },
                {
                    "days": "2126",
                    "times": [
                        "2035"
                    ]
                },
                {
                    "days": "2127",
                    "times": [
                        "08:45 - 10:00",
                        "10:30 - 11:00",
                        "11:45 - 12:15",
                        "12:15 - 13:15",
                        "13:45 - 14:15",
                        "15:00 - 15:45"
                    ]
                },
                {
                    "days": "2128",
                    "times": [
                        "09:30 - 10:15",
                        "11:15 - 12:00",
                        "12:00 - 13:45",
                        "09:30 - 10:15",
                        "11:15 - 12:00",
                        "12:00 - 13:45"
                    ]
                },
                {
                    "days": "2129",
                    "times": [
                        "2035"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "09:30 - 10:15",
                        "11:15 - 12:00",
                        "12:00 - 13:45"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "10:15 - 12:45",
                        "12:45 - 13:30",
                        "14:00 - 14:30",
                        "15:15 - 16:00"
                    ]
                }
            ]
        },
        {
            "name": "6573",
            "description": null,
            "type": "takeout",
            "hours": [
                {
                    "days": "2125",
                    "times": [
                        "3507"
                    ]
                },
                {
                    "days": "2126",
                    "times": [
                        "06:15 - 07:30",
                        "10:00 - 12:45",
                        "3841"
                    ]
                },
                {
                    "days": "2127",
                    "times": [
                        "08:30 - 09:30",
                        "14:30 - 15:45",
                        "3841"
                    ]
                },
                {
                    "days": "2128",
                    "times": [
                        "12:00 - 13:15",
                        "13:45 - 14:15",
                        "14:15 - 14:45",
                        "14:45 - 15:00",
                        "15:15 - 15:45",
                        "16:00 - 16:45",
                        "12:00 - 13:15",
                        "13:45 - 14:15",
                        "14:15 - 14:45",
                        "14:45 - 15:00",
                        "15:15 - 15:45",
                        "16:00 - 16:45",
                        "3841"
                    ]
                },
                {
                    "days": "2129",
                    "times": [
                        "12:00 - 13:15",
                        "13:45 - 14:15",
                        "14:15 - 14:45",
                        "14:45 - 15:00",
                        "15:15 - 15:45",
                        "16:00 - 16:45",
                        "3841"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "10:00 - 11:15",
                        "11:30 - 12:45",
                        "12:45 - 13:00",
                        "14:30 - 14:45",
                        "15:15 - 15:45",
                        "16:00 - 16:15",
                        "10:00 - 11:15",
                        "11:30 - 12:45",
                        "12:45 - 13:00",
                        "14:30 - 14:45",
                        "15:15 - 15:45",
                        "16:00 - 16:15",
                        "3841"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "10:00 - 11:15",
                        "11:30 - 12:45",
                        "12:45 - 13:00",
                        "14:30 - 14:45",
                        "15:15 - 15:45",
                        "16:00 - 16:15",
                        "3841"
                    ]
                }
            ]
        },
        {
            "name": "6574",
            "description": null,
            "type": "delivery",
            "hours": [
                {
                    "days": "2118 - 2119",
                    "times": [
                        "3507"
                    ]
                },
                {
                    "days": "2127",
                    "times": [
                        "09:00 - 13:00",
                        "09:00 - 13:00",
                        "09:00 - 13:00",
                        "3841"
                    ]
                },
                {
                    "days": "2121 - 2122",
                    "times": [
                        "09:00 - 13:00",
                        "3841"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "3507"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "10:15 - 10:30",
                        "11:45 - 12:30",
                        "12:45 - 13:00",
                        "14:45 - 15:45",
                        "16:15 - 17:00",
                        "3841"
                    ]
                }
            ]
        }
    ],
    "contact": {
        "address": {
            "street": "Van de Veldedreef",
            "nr": "32",
            "zipcode": "7941",
            "city": "Landen",
            "country": "BE"
        },
        "telephone": "+32 479 44 77 88",
        "vat": "BE 0335606977",
        "social": {},
        "website": null,
        "email": "wtimmermans@example.com"
    },
    "messages": [],
    "info": []
}

Example response 4 Shop with offer

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

{
    "id": 3149,
    "name": "Scents Time Immemorial",
    "address": {
        "street": "Declercqsingel",
        "nr": "38",
        "zipcode": "7830",
        "city": "Ciney",
        "country": "BE",
        "position": {
            "latitude": 51.05,
            "longitude": 3.71667
        }
    },
    "allow_comments": false,
    "currency": "EUR",
    "images": {
        "avatar": {
            "resolutions": [
                {
                    "src": "https://bakeronline.be/uploads/shop-avatars/3149/180x180/bakkerij-van-hecke-sint-martens-latem.jpg",
                    "width": 178,
                    "height": 178
                }
            ]
        },
        "banner": {
            "resolutions": [
                {
                    "src": "https://bakeronline.be/uploads/banner/3149/1300x315/patisserie-courcelles.gif",
                    "width": 241,
                    "height": 241
                }
            ]
        }
    },
    "allow_orders": true,
    "delivery_use_intervals": false,
    "categories": [
        {
            "id": 4167,
            "name": "Orchid",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4168,
            "name": "MediumBlue",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        },
        {
            "id": 4170,
            "name": "MediumOrchid",
            "banner": null,
            "seo": {
                "title": [],
                "description": [],
                "url": []
            }
        }
    ],
    "offers": [
        {
            "id": 222,
            "name": "Black Friday"
        }
    ],
    "category_groups": [],
    "hours": [
        {
            "name": "6572",
            "description": null,
            "type": "open",
            "hours": [
                {
                    "days": "2125",
                    "times": [
                        "11:00 - 12:00",
                        "15:30 - 19:15",
                        "11:00 - 12:00",
                        "15:30 - 19:15",
                        "11:00 - 12:00",
                        "15:30 - 19:15"
                    ]
                },
                {
                    "days": "2119 - 2120",
                    "times": [
                        "11:00 - 12:00",
                        "15:30 - 19:15"
                    ]
                },
                {
                    "days": "2128",
                    "times": [
                        "09:30 - 09:45",
                        "10:00 - 11:15",
                        "12:00 - 12:30",
                        "12:30 - 13:45",
                        "14:00 - 14:45",
                        "15:00 - 15:15",
                        "09:30 - 09:45",
                        "10:00 - 11:15",
                        "12:00 - 12:30",
                        "12:30 - 13:45",
                        "14:00 - 14:45",
                        "15:00 - 15:15"
                    ]
                },
                {
                    "days": "2129",
                    "times": [
                        "09:30 - 09:45",
                        "10:00 - 11:15",
                        "12:00 - 12:30",
                        "12:30 - 13:45",
                        "14:00 - 14:45",
                        "15:00 - 15:15"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "06:00 - 07:00",
                        "09:15 - 12:00"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "08:15 - 09:00",
                        "13:15 - 15:15"
                    ]
                }
            ]
        },
        {
            "name": "6573",
            "description": null,
            "type": "takeout",
            "hours": [
                {
                    "days": "2125",
                    "times": [
                        "09:00 - 09:45",
                        "12:00 - 13:00",
                        "09:00 - 09:45",
                        "12:00 - 13:00",
                        "3841"
                    ]
                },
                {
                    "days": "2126",
                    "times": [
                        "09:00 - 09:45",
                        "12:00 - 13:00",
                        "3841"
                    ]
                },
                {
                    "days": "2127",
                    "times": [
                        "10:15 - 10:45",
                        "10:45 - 12:45",
                        "12:45 - 13:30",
                        "15:00 - 16:15",
                        "10:15 - 10:45",
                        "10:45 - 12:45",
                        "12:45 - 13:30",
                        "15:00 - 16:15",
                        "3841"
                    ]
                },
                {
                    "days": "2128",
                    "times": [
                        "10:15 - 10:45",
                        "10:45 - 12:45",
                        "12:45 - 13:30",
                        "15:00 - 16:15",
                        "3841"
                    ]
                },
                {
                    "days": "2129",
                    "times": [
                        "16:15 - 20:00",
                        "3841"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "05:45 - 06:15",
                        "06:45 - 08:45",
                        "09:45 - 10:00",
                        "10:30 - 11:00",
                        "05:45 - 06:15",
                        "06:45 - 08:45",
                        "09:45 - 10:00",
                        "10:30 - 11:00",
                        "3841"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "05:45 - 06:15",
                        "06:45 - 08:45",
                        "09:45 - 10:00",
                        "10:30 - 11:00",
                        "3841"
                    ]
                }
            ]
        },
        {
            "name": "6574",
            "description": null,
            "type": "delivery",
            "hours": [
                {
                    "days": "2125",
                    "times": [
                        "05:45 - 07:00",
                        "08:00 - 09:30",
                        "09:45 - 10:15",
                        "10:30 - 11:00",
                        "11:30 - 12:00",
                        "12:30 - 12:45",
                        "3841"
                    ]
                },
                {
                    "days": "2126",
                    "times": [
                        "11:45 - 13:00",
                        "11:45 - 13:00",
                        "3841"
                    ]
                },
                {
                    "days": "2127",
                    "times": [
                        "11:45 - 13:00",
                        "3841"
                    ]
                },
                {
                    "days": "2128",
                    "times": [
                        "05:00 - 06:15",
                        "06:15 - 06:45",
                        "06:45 - 07:00",
                        "07:15 - 08:00",
                        "08:45 - 09:00",
                        "09:15 - 09:30",
                        "3841"
                    ]
                },
                {
                    "days": "2129",
                    "times": [
                        "05:45 - 06:30",
                        "06:30 - 06:45",
                        "07:30 - 10:30",
                        "10:45 - 11:30",
                        "3841"
                    ]
                },
                {
                    "days": "2130",
                    "times": [
                        "11:45 - 14:30",
                        "11:45 - 14:30",
                        "3841"
                    ]
                },
                {
                    "days": "2131",
                    "times": [
                        "11:45 - 14:30",
                        "3841"
                    ]
                }
            ]
        }
    ],
    "contact": {
        "address": {
            "street": "Declercqsingel",
            "nr": "38",
            "zipcode": "7830",
            "city": "Ciney",
            "country": "BE"
        },
        "telephone": "+32 479 44 77 88",
        "vat": "BE 0391281615",
        "social": {},
        "website": null,
        "email": "bauwens.juliette@example.com"
    },
    "messages": [],
    "info": []
}
Version update available Please adjust your integration to the latest stable version (1.5.2)
1.5.0 stable