Shop

The Shop resource is a collection of the general settings and information about the store.

Shop

The resource lets you retrieve information about the store but doesn't let you update any information. Only the merchant can update this information from inside the Shopify admin.

What you can do with Shop

The Shopify API lets you do the following with the Shop resource. More detailed versions of these general actions may be available:

Shop properties

address1
"address1": "1 Infinite Loop"

The shop's street address.

address2
"address2": "Suite 100"

The the optional second line of the shop's street address.

city
"city": "Cupertino"

The shop\s city.

country
"country": "US"

The shop's country. In most cases matches the country_code.

country_code
"country_code": "US"

The two-letter country code corresponding to the shop's country.

country_name
"country_name": "United States"

The shop's normalized country name.

created_at
"created_at": "2007-12-31T19:00:00-05:00"

The date and time (ISO 8601) when the shop was created.

updated_at
"updated_at": "2007-12-31T19:00:00-05:00"

The date and time (ISO 8601) when the shop was last updated.

customer_email
"customer_email": "customers@apple.com"

The contact email used for communication between the shop owner and the customer.

currency
"currency": "USD"

The three-letter code for the currency that the shop accepts.

domain
"domain": "shop.apple.com"

The shop's domain.

email
"email": "steve@apple.com"

The contact email used for communication between Shopify and the shop owner.

google_apps_domain
"google_apps_domain": null

The GSuite URL for the store, if applicable.

google_apps_login_enabled
"google_apps_login_enabled": null

Whether the GSuite login is enabled. Shops with this feature will be able to log in through the GSuite login page. Valid values: true, null

id
"id": 690933842

The ID for the shop.

latitude
"latitude": 45.427408

The latitude of the shop's location.

longitude
"longitude": -75.68903

The longitude of the shop's location.

money_format
"money_format": "$"

A string representing the way currency is formatted when the currency isn't specified.

money_with_currency_format
"money_with_currency_format": "$ USD"

A string representing the way currency is formatted when the currency is specified.

weight_unit
"weight_unit": "lb"

The default unit of weight measurement for the shop.

myshopify_domain
"myshopify_domain": "apple.myshopify.com"

The shop's myshopify.com domain.

name
"name": "Apple Computers"

The name of the shop.

plan_name
"plan_name": "enterprise"

The name of the Shopify plan the shop is on.

has_discounts
"has_discounts": false

Whether any active discounts exist for the shop.

has_gift_cards
"has_gift_cards": true

Whether any active gift cards exist for the shop.

plan_display_name
"plan_display_name": "enterprise"

The display name of the Shopify plan the shop is on.

password_enabled
"password_enabled": false

Whether the password protection page is enabled on the online storefront.

pre_launch_enabled
"pre_launch_enabled": false

Whether the pre-launch page is enabled on the online storefront.

phone
"phone": null

The contact phone number for the shop.

primary_locale
"primary_locale": "fr"

The shop's primary locale.

province
"province": "California"

The shop's normalized province or state name.

province_code
"province_code": "CA"

The two-letter code for the shop's province or state.

shop_owner
"shop_owner": "Steve Jobs"

The username of the shop owner.

source
"source": null

The handle of the partner account that referred the merchant to Shopify, if applicable.

force_ssl
"force_ssl": true

Whether the shop forces requests made to its resources to be made over SSL using the HTTPS protocol. Valid values: true or false.

tax_shipping
"tax_shipping": null

Whether taxes were charged for shipping. Valid values: true or false.

taxes_included
"taxes_included": null

Whether applicable taxes are included in product prices. Valid values: true or null.

county_taxes
"county_taxes": null

Whether the shop is applying taxes on a per-county basis. Only applicable to shops based in the US. Valid values: true or null."

timezone
"timezone": "(GMT-05:00) Eastern Time"

The name of the timezone the shop is in.

iana_timezone
"iana_timezone": "America/New_York"

The name of the timezone assigned by the IANA.

zip
"zip": "95014"

The shop's zip or postal code.

has_storefront
"has_storefront": true

Whether the shop has an online storefront.

setup_required
"setup_required": false

Whether the shop has any outstanding setup steps or not.

checkout_api_supported
"checkout_api_supported": true

Whether the store is capable of accepting payments directly through the Checkout API.

Endpoints

GET /admin/shop.json
Retrieves the shop's configuration
fields

A comma-separated list of fields to include in the response.

Retrieve the shop's configuration

GET /admin/shop.json
View Response
HTTP/1.1 200 OK
{
  "shop": {
    "id": 690933842,
    "name": "Apple Computers",
    "email": "steve@apple.com",
    "domain": "shop.apple.com",
    "province": "California",
    "country": "US",
    "address1": "1 Infinite Loop",
    "zip": "95014",
    "city": "Cupertino",
    "source": null,
    "phone": "1231231234",
    "latitude": 45.45,
    "longitude": -75.43,
    "primary_locale": "en",
    "address2": "Suite 100",
    "created_at": "2007-12-31T19:00:00-05:00",
    "updated_at": "2018-05-07T15:43:03-04:00",
    "country_code": "US",
    "country_name": "United States",
    "currency": "USD",
    "customer_email": "customers@apple.com",
    "timezone": "(GMT-05:00) Eastern Time (US & Canada)",
    "iana_timezone": "America/New_York",
    "shop_owner": "Steve Jobs",
    "money_format": "${{amount}}",
    "money_with_currency_format": "${{amount}} USD",
    "weight_unit": "lb",
    "province_code": "CA",
    "taxes_included": null,
    "tax_shipping": null,
    "county_taxes": true,
    "plan_display_name": "Shopify Plus",
    "plan_name": "enterprise",
    "has_discounts": true,
    "has_gift_cards": true,
    "myshopify_domain": "apple.myshopify.com",
    "google_apps_domain": null,
    "google_apps_login_enabled": null,
    "money_in_emails_format": "${{amount}}",
    "money_with_currency_in_emails_format": "${{amount}} USD",
    "eligible_for_payments": true,
    "requires_extra_payments_agreement": false,
    "password_enabled": false,
    "has_storefront": true,
    "eligible_for_card_reader_giveaway": false,
    "finances": true,
    "primary_location_id": 905684977,
    "checkout_api_supported": true,
    "multi_location_enabled": false,
    "setup_required": false,
    "force_ssl": true,
    "pre_launch_enabled": false
  }
}