Storefront API
- Authentication
- Account
- Account / Address
- Account / Credit Cards
- Account / Orders
- Order Status
- Cart
- Cart / Line Items
- Cart / Other
- Cart / Coupons
- Checkout
- Checkout / State
- Checkout / Shipments
- Checkout / Payments
- Checkout / Store Credit
- Products
- Stores
- Taxons
- Countries
- CMS Pages
- Menus
- Wishlists
- Wishlists / Wished Items
- Digital Downloads
Platform API
- Authentication
- Addresses
- Adjustments
- Classifications
- CMS Pages
- CMS Sections
- Countries
- Data Feeds
- Digital Links
- Digital Assets
- Line Items
- Menu Items
- Menus
- Option Types
- Option Values
- Orders
- Payment Methods
- Payments
- Products
- Promotion Actions
- Promotion Categories
- Promotion Rules
- Promotions
- Roles
- Shipments
- Shipping Categories
- Shipping Methods
- States
- Stock Items
- Stock Locations
- Store Credit Categories
- Store Credit Types
- Store Credits
- Tax Categories
- Tax Rates
- Taxonomies
- Taxons
- Users
- Variants
- Webhook Events
- Webhook Subscribers
- Wished Items
- Wishlists
- Zones
Return the current Store
Returns the current Store. Read more about Stores
curl --request GET \
--url https://demo.spreecommerce.org/api/v2/storefront/store \
--header 'Authorization: Bearer <token>'
{
"data": {
"id": "3",
"type": "store",
"attributes": {
"name": "Mystore",
"url": "spree-demo.com",
"meta_description": "Luxury clothing store for men and women.",
"meta_keywords": "luxury clothing men women",
"seo_title": "",
"default_currency": "USD",
"default": true,
"supported_currencies": "EUR,GBP,USD",
"facebook": "https://www.facebook.com/mystorename",
"twitter": "https://twitter.com/mystorename",
"instagram": "https://instagram.com/mystorename",
"default_locale": "en",
"customer_support_email": "support@mystore.com",
"description": "Mystore has been selling luxury clothing for more than 20 years and has 15 stores currently.",
"address": "813 Howard Street, Oswego NY 13126, USA",
"contact_phone": "+123456789",
"supported_locales": "en",
"favicon_path": "/assets/favicon.ico"
},
"relationships": {
"menus": {
"data": [
{
"id": "10",
"type": "menu"
},
{
"id": "11",
"type": "menu"
}
]
},
"cms_pages": {
"data": [
{
"id": "5",
"type": "cms_page"
}
]
},
"default_country": {
"data": {
"id": "2",
"type": "country"
}
}
}
}
}
Authorizations
User token to authorize Cart and Checkout requests.
It is required to associate Cart with the User.
Query Parameters
Specify what related resources (relationships) you would like to receive in the response body. Eg.
default_country,menus,cms_pages
Specify the fields you would like returned in the response body. More information.
Response
Stores are the center of the Spree ecosystem. Each Spree installation can have multiple Stores. Each Store operates on a different domain or subdomain.
Name of the Store
Store Url
Meta description for SEO
Meta keywords for SEO
The title for SEO
Default currency of the store
Indicates if the Store is the default one
All currencies supported by store
URL of Facebook page
URL of Twitter page
URL of Instagram page
Default locale of the Store
Supported locales of the Store
This email is visible to your Store visitors in the Footer section
Description of the Store which is visible in the Footer
Address of the Store which is visible in the Footer
Contact phone number of the Store which is visible in the Footer
Countries within Spree are used as a container for states. Countries can be zone members, and also link to an address. The difference between one country and another on an address record can determine which tax rates and shipping methods are used for the order.Read more about Countries in Spree
States associated with this Country
States within Spree are used to scope address data slightly more than country. States are useful for tax purposes, as different states in a country may impose different tax rates on different products. In addition to this, different states may cause different tax rates and shipping methods to be used for an order, similar to how countries affect it also.
Was this page helpful?
curl --request GET \
--url https://demo.spreecommerce.org/api/v2/storefront/store \
--header 'Authorization: Bearer <token>'
{
"data": {
"id": "3",
"type": "store",
"attributes": {
"name": "Mystore",
"url": "spree-demo.com",
"meta_description": "Luxury clothing store for men and women.",
"meta_keywords": "luxury clothing men women",
"seo_title": "",
"default_currency": "USD",
"default": true,
"supported_currencies": "EUR,GBP,USD",
"facebook": "https://www.facebook.com/mystorename",
"twitter": "https://twitter.com/mystorename",
"instagram": "https://instagram.com/mystorename",
"default_locale": "en",
"customer_support_email": "support@mystore.com",
"description": "Mystore has been selling luxury clothing for more than 20 years and has 15 stores currently.",
"address": "813 Howard Street, Oswego NY 13126, USA",
"contact_phone": "+123456789",
"supported_locales": "en",
"favicon_path": "/assets/favicon.ico"
},
"relationships": {
"menus": {
"data": [
{
"id": "10",
"type": "menu"
},
{
"id": "11",
"type": "menu"
}
]
},
"cms_pages": {
"data": [
{
"id": "5",
"type": "cms_page"
}
]
},
"default_country": {
"data": {
"id": "2",
"type": "country"
}
}
}
}
}