> ## 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.

# Get Default Country

> Returns the default country for the current store. By default this will be the US.



## OpenAPI

````yaml /api-reference/storefront.yaml get /api/v2/storefront/countries/default
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/countries/default:
    get:
      tags:
        - Countries
      summary: Get Default Country
      description: >-
        Returns the default country for the current store. By default this will
        be the US.
      operationId: default-country
      parameters:
        - $ref: '#/components/parameters/CountryIncludeParam'
        - $ref: '#/components/parameters/SparseFieldsCountry'
      responses:
        '200':
          $ref: '#/components/responses/Country'
components:
  parameters:
    CountryIncludeParam:
      name: include
      in: query
      schema:
        type: string
      description: >-
        Specify the related resources you would like to receive in the response
        body. [More Information](https://jsonapi.org/format/#fetching-includes).
      example: states
    SparseFieldsCountry:
      name: fields[country]
      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: iso_name,name,states_required
  responses:
    Country:
      description: 200 Success - Returns the `country` object.
      content:
        application/vnd.api+json:
          schema:
            type: object
            properties:
              data:
                $ref: '#/components/schemas/Country'
              included:
                type: array
                items:
                  $ref: '#/components/schemas/CountryIncludes'
            required:
              - data
  schemas:
    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
    CountryIncludes:
      x-internal: false
      title: Country Includes
      oneOf:
        - $ref: '#/components/schemas/State'
    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

````