Docs / API Overview

Shops

Data references

A shop represents a single sales location, either a brick-and-mortar store or a e-commerce site.

Fields

Mandatory fields

Field Type Description
external_id string Your unique identifier for the shop.

Optional fields

Field Type Description
name string Name of the store.
email string Email address.
shop_type string "offline" for brick-and-mortar stores and "online" for webstores and other online properties.
phone_number phone_number Phone number to the store, e.g. +358101234567.
street_address string Street address of the store, e.g. Main Street 123.
city string City that the store is in, e.g. London.
country country_code Two-letter country code, e.g. GB.
is_hidden boolean Determines whether the shop is hidden from the user interface; defaults to false.

Example

To upload new or changed shop information, you may pass them to Custobar using a HTTP POST command, e.g.

curl -X POST -u USER -H "Content-Type: application/json" \
    --data-binary @shops.json https://COMPANY.custobar.com/api/shops/upload/

The shop objects must be provided as a list, wrapped into a JSON object, with a key shops, as shown in the example below.

{
  "shops": [
    {
      "external_id": "BAKER-STREET",
      "name": "Baker Street Boutique",
      "shop_type": "offline",
      "city": "London",
      "country": "GB",
      "COMPANY__opening_hours": "24/7"
    }
  ]
}