> ## Documentation Index
> Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Return the current Store

> Returns the current Store. [Read more about Stores](/developer/core-concepts/stores)



## OpenAPI

````yaml /api-reference/storefront.yaml get /api/v2/storefront/store
openapi: 3.0.3
info:
  version: 2.0.0
  title: Storefront API
  description: >-
    Storefront API is a modern REST API based on the [JSON API
    spec](https://jsonapi.org/) which provides you with all the necessary
    endpoints to build amazing user interfaces either in JavaScript frameworks
    or native mobile libraries.


    Import to
    [Postman](https://raw.githubusercontent.com/spree/spree/main/docs/api-reference/storefront.yaml)
  contact:
    name: Vendo Connect Inc.
    url: https://spreecommerce.org
    email: hello@spreecommerce.org
  license:
    name: BSD-3-Clause
    url: https://github.com/spree/spree/blob/main/LICENSE.md
servers:
  - url: https://demo.spreecommerce.org
    description: demo
  - url: http://localhost:3000
    description: localhost
security: []
tags:
  - name: Account
  - name: Account / Address
  - name: Account / Credit Cards
  - name: Account / Orders
  - name: Cart
  - name: Cart / Line Items
  - name: Cart / Coupons
  - name: Cart / Other
  - name: Checkout
  - name: Checkout / State
  - name: Checkout / Shipments
  - name: Checkout / Payments
  - name: Checkout / Store Credit
  - name: Stripe
  - name: Adyen
  - name: Countries
  - name: Digital Downloads
  - name: Order Status
  - name: Products
  - name: Variants
  - name: Stores
  - name: Policies
  - name: Taxons
  - name: Vendors
  - name: Wishlists
  - name: Wishlists / Wished Items
paths:
  /api/v2/storefront/store:
    get:
      tags:
        - Stores
      summary: Return the current Store
      description: >-
        Returns the current Store. [Read more about
        Stores](/developer/core-concepts/stores)
      operationId: show-current-store
      parameters:
        - $ref: '#/components/parameters/StoreIncludeParam'
        - $ref: '#/components/parameters/SparseFieldsStore'
      responses:
        '200':
          $ref: '#/components/responses/Store'
        '403':
          $ref: '#/components/responses/403Forbidden'
components:
  parameters:
    StoreIncludeParam:
      name: include
      in: query
      schema:
        type: string
      description: >-
        Specify what related resources (relationships) you would like to receive
        in the response body. Eg.


        ```

        default_country

        ```


        [More information](https://jsonapi.org/format/#fetching-includes)
      example: default_country
    SparseFieldsStore:
      name: fields[store]
      in: query
      description: >-
        Specify the fields you would like returned in the response body. [More
        information](https://jsonapi.org/format/#fetching-sparse-fieldsets).
      schema:
        type: string
      example: name,url,supported_locales
  responses:
    Store:
      description: 200 Success - Returns the `store` object.
      content:
        application/vnd.api+json:
          schema:
            type: object
            properties:
              data:
                $ref: '#/components/schemas/Store'
              included:
                type: array
                items:
                  $ref: '#/components/schemas/StoreIncludes'
            required:
              - data
          examples:
            Store without includes:
              value:
                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:
                    default_country:
                      data:
                        id: '2'
                        type: country
            Store with Includes:
              value:
                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:
                    default_country:
                      data:
                        id: '2'
                        type: country
                included:
                  - id: '2'
                    type: country
                    attributes:
                      iso: US
                      iso3: USA
                      iso_name: UNITED STATES
                      name: United States
                      states_required: true
                      zipcode_required: true
                      default: true
                    relationships:
                      checkout_zone_applicable_states:
                        data: []
    403Forbidden:
      description: 403 Forbidden - You are not authorized to access this page.
      content:
        application/vnd.api+json:
          schema:
            properties:
              error:
                type: string
                example: You are not authorized to access this page.
                default: You are not authorized to access this page.
          examples:
            403 Example:
              value:
                error: You are not authorized to access this page.
  schemas:
    Store:
      type: object
      description: >-
        Stores are the center of the Spree ecosystem. Each Spree installation
        can have multiple Stores. Each Store operates on a different domain or
        subdomain.
      title: Store
      x-internal: false
      properties:
        id:
          type: string
          example: '1'
        type:
          type: string
          default: store
        attributes:
          type: object
          properties:
            name:
              type: string
              example: Spree Demo
              description: Name of the Store
            url:
              type: string
              example: spree-demo.com
              description: Store Url
            meta_description:
              type: string
              example: Luxury clothing store for men and women.
              description: Meta description for SEO
            meta_keywords:
              type: string
              example: luxury clothing men women
              description: Meta keywords for SEO
            seo_title:
              type: string
              example: Buy Luxury Clothing With Ease
              description: The title for SEO
            default_currency:
              type: string
              example: EUR
              description: Default currency of the store
            default:
              type: boolean
              example: true
              description: Indicates if the Store is the default one
            supported_currencies:
              type: string
              example: EUR,USD,GBP
              description: All currencies supported by store
            facebook:
              type: string
              example: https://www.facebook.com/mystorename
              description: URL of Facebook page
            twitter:
              type: string
              example: https://twitter.com/mystorename
              description: URL of Twitter page
            instagram:
              type: string
              example: https://instagram.com/mystorename
              description: URL of Instagram page
            default_locale:
              type: string
              example: en
              description: Default locale of the Store
            supported_locales:
              type: string
              example: en,es,de
              description: Supported locales of the Store
            customer_support_email:
              type: string
              example: support@mystore.com
              description: >-
                This email is visible to your Store visitors in the Footer
                section
            description:
              type: string
              example: >-
                Mystore has been selling luxury clothing for more than 20 years
                and has 15 stores currently.
              description: Description of the Store which is visible in the Footer
            address:
              type: string
              example: 813 Howard Street, Oswego NY 13126, USA
              description: Address of the Store which is visible in the Footer
            contact_phone:
              type: string
              example: '+123456789'
              description: Contact phone number of the Store which is visible in the Footer
            favicon_path:
              type: string
              example: /assets/favicon.ico
        relationships:
          type: object
          properties:
            default_country:
              type: object
              description: Default Country of the Store
              properties:
                data:
                  $ref: '#/components/schemas/Relation'
      required:
        - id
        - type
        - attributes
        - relationships
    StoreIncludes:
      x-internal: false
      title: Store Includes
      anyOf:
        - $ref: '#/components/schemas/Country'
    Relation:
      type: object
      nullable: true
      properties:
        id:
          type: string
        type:
          type: string
      required:
        - id
        - type
      x-internal: false
      description: ''
    Country:
      title: Country
      description: >-
        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](/developer/core-concepts/addresses#countries)
      type: object
      x-internal: false
      properties:
        id:
          type: string
          example: '1'
        type:
          type: string
          default: country
        attributes:
          type: object
          properties:
            iso:
              type: string
              example: US
            iso3:
              type: string
              example: USA
            iso_name:
              type: string
              example: UNITED STATES
            name:
              type: string
              example: United States
            states_required:
              type: boolean
            zipcode_required:
              type: boolean
            default:
              type: boolean
        relationships:
          type: object
          properties:
            states:
              type: object
              description: States associated with this Country
              properties:
                data:
                  type: array
                  items:
                    $ref: '#/components/schemas/State'
      required:
        - id
        - type
        - attributes
        - relationships
    State:
      type: object
      description: >-
        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.
      title: State
      properties:
        abbr:
          type: string
          example: NY
          description: State abbreviation
        name:
          type: string
          example: New York
          description: State name
      x-internal: false

````