Shop

The Shopify API's shop object is a collection of the general settings and information about the shop.

Shop

Only the shop owner can edit this information from inside their shop admin dashboard by navigating to the "Settings" tab and selecting the "General" tab. The API doesn't let you do anything other than retrieve information about a shop.

What can you 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 shop's additional street address (apt, suite, etc.).

city
{ "city" : "Cupertino" }

The city in which the shop is located.

country
{ "country" : "US" }

The shop's country (by default equal to the two-letter 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 when the shop was created. The API returns this value in ISO 8601 format.

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

The date and time when the shop was last updated. The API returns this value in ISO 8601 format.

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

The customer's email.

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 address for the shop.

google_apps_domain
{ "google_apps_domain" : null }

Feature is present when a shop has a google app domain. It will be returned as a URL. If the shop does not have this feature enabled it will default to "null."

google_apps_login_enabled
{ "google_apps_login_enabled" : null }

Feature is present if a shop has google apps enabled. Those shops with this feature will be able to login to the google apps login. Shops without this feature enabled will default to "null."

id
{ "id" : 690933842 }

A unique numeric identifier for the shop.

latitude
{ "latitude" : 45.427408 }

Geographic coordinate specifying the north/south location of a shop.

longitude
{ "longitude" : -75.68903 }

Geographic coordinate specifying the east/west location of a shop.

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.

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 }

Indicates if any active discounts exist for the shop.

has_gift_cards
{ "has_gift_cards" : true }

Indicates if 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 }

Indicates whether the Storefront password protection is enabled.

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 }

force_ssl
{ "force_ssl" : true }

Indicates whether the shop forces requests made to its resources to be made over SSL, using the HTTPS protocol. If true, HTTP requests will be redirected to HTTPS.

tax_shipping
{ "tax_shipping" : null }

Specifies whether or not taxes were charged for shipping. Valid values are: "true" or "false."

taxes_included
{ "taxes_included" : null }

The setting for whether applicable taxes are included in product prices. Valid values are: "true" or "null."

county_taxes
{ "county_taxes" : null }

The setting for whether the shop is applying taxes on a per-county basis or not (US-only). Valid values are: "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 named timezone assigned by the IANA.

zip
{ "zip" : "95014" }

The zip or postal code of the shop's address.

has_storefront
{ "has_storefront" : true }

Indicates whether the shop has web-based storefront or not.

setup_required
{ "setup_required" : false }

Indicates whether the shop has any outstanding setup steps or not.

Endpoints

GET /admin/shop.json

Get the configuration of the shop account

fields

comma-separated list of fields to include in the response

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",
    "created_at": "2007-12-31T19:00:00-05:00",
    "province": "California",
    "country": "US",
    "address1": "1 Infinite Loop",
    "zip": "95014",
    "city": "Cupertino",
    "source": null,
    "phone": "1231231234",
    "updated_at": "2016-11-09T13:49:41-05:00",
    "customer_email": "customers@apple.com",
    "latitude": 45.45,
    "longitude": -75.43,
    "primary_location_id": null,
    "primary_locale": "en",
    "address2": "Suite 100",
    "country_code": "US",
    "country_name": "United States",
    "currency": "USD",
    "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",
    "province_code": "CA",
    "taxes_included": null,
    "tax_shipping": null,
    "county_taxes": true,
    "plan_display_name": "Shopify Plus",
    "plan_name": "enterprise",
    "has_discounts": false,
    "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,
    "setup_required": false,
    "force_ssl": false
  }
}