Shop

This page was printed on Aug 20, 2019. For the current version, visit https://help.shopify.com/en/api/reference/store-properties/shop.

Version 2019-04

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

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:

GET /admin/api/#{api_version}/shop.json Retrieves the shop's configuration

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.
checkout_api_supported	`"checkout_api_supported": true` Whether the shop is capable of accepting payments directly through the Checkout API.
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.
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`."
created_at	`"created_at": "2007-12-31T19:00:00-05:00"` The date and time (ISO 8601) when the shop was created.
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 (ISO 4217 format) for the shop's default currency.
domain	`"domain": "shop.apple.com"` The shop's domain.
enabled_presentment_currencies	`"enabled_presentment_currencies": [ "CAD", "GBP", "USD", "JPY" ]` A list of enabled currencies (ISO 4217 format) that the shop accepts. Merchants can enable currencies from their Shopify Payments settings in the Shopify admin.
eligible_for_card_reader_giveaway	`"eligible_for_card_reader_giveaway": true` Whether the shop is eligible to receive a free credit card reader from Shopify.
eligible_for_payments	`"eligible_for_payments": true` Whether the shop is eligible to use Shopify Payments.
email	`"email": "steve@apple.com"` The contact email used for communication between Shopify and the shop owner.
finances deprecated	`"finances": true` This field has been deprecated, and is currently unused. Hardcoded to `true`.
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`.
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`
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.
has_storefront	`"has_storefront": true` Whether the shop has an online storefront.
iana_timezone	`"iana_timezone": "America/New_York"` The name of the timezone assigned by the IANA.
id	`"id": 690933842` The ID for the shop. A 64-bit unsigned integer.
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_in_emails_format	`"money_in_emails_format": "$"` A string representing the way currency is formatted in email notifications 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.
money_with_currency_in_emails_format	`"money_with_currency_in_emails_format": "$ USD"` A string representing the way currency is formatted in email notifications when the currency is specified.
multi_location_enabled	`"multi_location_enabled": false` Whether the shop has enabled multiple locations.
myshopify_domain	`"myshopify_domain": "apple.myshopify.com"` The shop's myshopify.com domain.
name	`"name": "Apple Computers"` The name of the shop.
password_enabled	`"password_enabled": false` Whether the password protection page is enabled on the online storefront.
phone	`"phone": null` The contact phone number for the shop.
plan_display_name	`"plan_display_name": "enterprise"` The display name of the Shopify plan the shop is on.
pre_launch_enabled	`"pre_launch_enabled": false` Whether the pre-launch page is enabled on the online storefront.
plan_name	`"plan_name": "enterprise"` The name of the Shopify plan the shop is on.
primary_locale	`"primary_locale": "fr"` The shop's primary locale, as configured in the language settings of the shop's theme.
primary_location_id deprecated	`"primary_location_id": 905684977` Formerly used for the ID of the shipping origin location (read only). Use the Location resource instead.
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.
requires_extra_payments_agreement	`"requires_extra_payments_agreement": false` Whether the shop requires an extra Shopify Payments agreement.
setup_required	`"setup_required": false` Whether the shop has any outstanding setup steps or not.
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.
taxes_included	`"taxes_included": null` Whether applicable taxes are included in product prices. Valid values: `true` or `null`.
tax_shipping	`"tax_shipping": null` Whether taxes are charged for shipping. Valid values: `true` or `false`.
timezone	`"timezone": "(GMT-05:00) Eastern Time"` The name of the timezone the shop is in.
updated_at	`"updated_at": "2007-12-31T19:00:00-05:00"` The date and time (ISO 8601) when the shop was last updated.
weight_unit	`"weight_unit": "lb"` The default unit of weight measurement for the shop.
zip	`"zip": "95014"` The shop's zip or postal code.

Endpoints

GET /admin/api/2019-07/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/api/#{api_version}/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": "2019-07-22T11:37:22-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,
    "enabled_presentment_currencies": [
      "USD"
    ]
  }
}

Version 2019-07 (Latest)

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

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:

GET /admin/api/#{api_version}/shop.json Retrieves the shop's configuration

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.
checkout_api_supported	`"checkout_api_supported": true` Whether the shop is capable of accepting payments directly through the Checkout API.
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.
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`."
created_at	`"created_at": "2007-12-31T19:00:00-05:00"` The date and time (ISO 8601) when the shop was created.
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 (ISO 4217 format) for the shop's default currency.
domain	`"domain": "shop.apple.com"` The shop's domain.
enabled_presentment_currencies	`"enabled_presentment_currencies": [ "CAD", "GBP", "USD", "JPY" ]` A list of enabled currencies (ISO 4217 format) that the shop accepts. Merchants can enable currencies from their Shopify Payments settings in the Shopify admin.
eligible_for_card_reader_giveaway	`"eligible_for_card_reader_giveaway": true` Whether the shop is eligible to receive a free credit card reader from Shopify.
eligible_for_payments	`"eligible_for_payments": true` Whether the shop is eligible to use Shopify Payments.
email	`"email": "steve@apple.com"` The contact email used for communication between Shopify and the shop owner.
finances deprecated	`"finances": true` This field has been deprecated, and is currently unused. Hardcoded to `true`.
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`.
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`
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.
has_storefront	`"has_storefront": true` Whether the shop has an online storefront.
iana_timezone	`"iana_timezone": "America/New_York"` The name of the timezone assigned by the IANA.
id	`"id": 690933842` The ID for the shop. A 64-bit unsigned integer.
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_in_emails_format	`"money_in_emails_format": "$"` A string representing the way currency is formatted in email notifications 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.
money_with_currency_in_emails_format	`"money_with_currency_in_emails_format": "$ USD"` A string representing the way currency is formatted in email notifications when the currency is specified.
multi_location_enabled	`"multi_location_enabled": false` Whether the shop has enabled multiple locations.
myshopify_domain	`"myshopify_domain": "apple.myshopify.com"` The shop's myshopify.com domain.
name	`"name": "Apple Computers"` The name of the shop.
password_enabled	`"password_enabled": false` Whether the password protection page is enabled on the online storefront.
phone	`"phone": null` The contact phone number for the shop.
plan_display_name	`"plan_display_name": "enterprise"` The display name of the Shopify plan the shop is on.
pre_launch_enabled	`"pre_launch_enabled": false` Whether the pre-launch page is enabled on the online storefront.
plan_name	`"plan_name": "enterprise"` The name of the Shopify plan the shop is on.
primary_locale	`"primary_locale": "fr"` The shop's primary locale, as configured in the language settings of the shop's theme.
primary_location_id deprecated	`"primary_location_id": 905684977` Formerly used for the ID of the shipping origin location (read only). Use the Location resource instead.
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.
requires_extra_payments_agreement	`"requires_extra_payments_agreement": false` Whether the shop requires an extra Shopify Payments agreement.
setup_required	`"setup_required": false` Whether the shop has any outstanding setup steps or not.
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.
taxes_included	`"taxes_included": null` Whether applicable taxes are included in product prices. Valid values: `true` or `null`.
tax_shipping	`"tax_shipping": null` Whether taxes are charged for shipping. Valid values: `true` or `false`.
timezone	`"timezone": "(GMT-05:00) Eastern Time"` The name of the timezone the shop is in.
updated_at	`"updated_at": "2007-12-31T19:00:00-05:00"` The date and time (ISO 8601) when the shop was last updated.
weight_unit	`"weight_unit": "lb"` The default unit of weight measurement for the shop.
zip	`"zip": "95014"` The shop's zip or postal code.

Endpoints

GET /admin/api/2019-07/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/api/#{api_version}/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": "2019-07-22T11:37:22-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,
    "enabled_presentment_currencies": [
      "USD"
    ]
  }
}

Version 2019-10 (Release candidate)

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

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:

GET /admin/api/#{api_version}/shop.json Retrieves the shop's configuration

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.
checkout_api_supported	`"checkout_api_supported": true` Whether the shop is capable of accepting payments directly through the Checkout API.
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.
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`."
created_at	`"created_at": "2007-12-31T19:00:00-05:00"` The date and time (ISO 8601) when the shop was created.
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 (ISO 4217 format) for the shop's default currency.
domain	`"domain": "shop.apple.com"` The shop's domain.
enabled_presentment_currencies	`"enabled_presentment_currencies": [ "CAD", "GBP", "USD", "JPY" ]` A list of enabled currencies (ISO 4217 format) that the shop accepts. Merchants can enable currencies from their Shopify Payments settings in the Shopify admin.
eligible_for_card_reader_giveaway	`"eligible_for_card_reader_giveaway": true` Whether the shop is eligible to receive a free credit card reader from Shopify.
eligible_for_payments	`"eligible_for_payments": true` Whether the shop is eligible to use Shopify Payments.
email	`"email": "steve@apple.com"` The contact email used for communication between Shopify and the shop owner.
finances deprecated	`"finances": true` This field has been deprecated, and is currently unused. Hardcoded to `true`.
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`.
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`
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.
has_storefront	`"has_storefront": true` Whether the shop has an online storefront.
iana_timezone	`"iana_timezone": "America/New_York"` The name of the timezone assigned by the IANA.
id	`"id": 690933842` The ID for the shop. A 64-bit unsigned integer.
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_in_emails_format	`"money_in_emails_format": "$"` A string representing the way currency is formatted in email notifications 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.
money_with_currency_in_emails_format	`"money_with_currency_in_emails_format": "$ USD"` A string representing the way currency is formatted in email notifications when the currency is specified.
multi_location_enabled	`"multi_location_enabled": false` Whether the shop has enabled multiple locations.
myshopify_domain	`"myshopify_domain": "apple.myshopify.com"` The shop's myshopify.com domain.
name	`"name": "Apple Computers"` The name of the shop.
password_enabled	`"password_enabled": false` Whether the password protection page is enabled on the online storefront.
phone	`"phone": null` The contact phone number for the shop.
plan_display_name	`"plan_display_name": "enterprise"` The display name of the Shopify plan the shop is on.
pre_launch_enabled	`"pre_launch_enabled": false` Whether the pre-launch page is enabled on the online storefront.
plan_name	`"plan_name": "enterprise"` The name of the Shopify plan the shop is on.
primary_locale	`"primary_locale": "fr"` The shop's primary locale, as configured in the language settings of the shop's theme.
primary_location_id deprecated	`"primary_location_id": 905684977` Formerly used for the ID of the shipping origin location (read only). Use the Location resource instead.
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.
requires_extra_payments_agreement	`"requires_extra_payments_agreement": false` Whether the shop requires an extra Shopify Payments agreement.
setup_required	`"setup_required": false` Whether the shop has any outstanding setup steps or not.
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.
taxes_included	`"taxes_included": null` Whether applicable taxes are included in product prices. Valid values: `true` or `null`.
tax_shipping	`"tax_shipping": null` Whether taxes are charged for shipping. Valid values: `true` or `false`.
timezone	`"timezone": "(GMT-05:00) Eastern Time"` The name of the timezone the shop is in.
updated_at	`"updated_at": "2007-12-31T19:00:00-05:00"` The date and time (ISO 8601) when the shop was last updated.
weight_unit	`"weight_unit": "lb"` The default unit of weight measurement for the shop.
zip	`"zip": "95014"` The shop's zip or postal code.

Endpoints

GET /admin/api/2019-07/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/api/#{api_version}/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": "2019-07-22T11:37:22-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,
    "enabled_presentment_currencies": [
      "USD"
    ]
  }
}

Shop

What you can do with Shop

Shop properties

Endpoints

Retrieve the shop's configuration

What you can do with Shop

Shop properties

Endpoints

Retrieve the shop's configuration

What you can do with Shop

Shop properties

Endpoints

Retrieve the shop's configuration

Sign up for a Partner account to get started.