---
title: Country
description: Manage the country and provincial tax rates that are applied to applicable items at checkout.
api_version: 2025-10
api_name: admin-rest
api_type: rest
source_url:
  html: https://shopify.dev/docs/api/admin-rest/latest/resources/country
  md: https://shopify.dev/docs/api/admin-rest/latest/resources/country.md
---

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).

# Country

Multiple access scopes needed — refer to each endpoint for access scope requirements.

Important

The REST Country API is deprecated as of version 2024-07.

Please refer to the documentation for each individual endpoint and the [developer changelog](https://shopify.dev/changelog/deprecation-notice-country-and-province-endpoints-in-admin-rest-api) for more information.

The Country resource represents the tax rates applied to orders from the different countries where a shop sells its products.

![](https://shopify.dev/assets/api/reference/country.png)

Merchants select the countries where they sell their products when they set up their shipping zones and rates on the **Shipping** page of the Shopify admin. After adding a country to a shipping zone, store owners can then verify and adjust tax rates for each country on the **Taxes** page.

The Country resource lets you access the countries and tax rates set up by the merchant. The countries list includes a default entry called **Rest of World**, which represents all non-specified countries.

You can use the Country resource to modify the sales tax rate for a country or sub-region to account for surtaxes or exemptions that apply to the store.

For more information on managing tax rates for sub-regions of a country, such as states or provinces, see the [Province](https://shopify.dev/docs/admin-api/rest/reference/store-properties/province) resource.

Caution

As of version 2020-10, you can no longer create or update custom tax values for the Country resource.

\#

## Endpoints

* [post](https://shopify.dev/docs/api/admin-rest/latest/resources/country#post-countries)

  [/admin/api/latest/countries.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/country#post-countries)

  Creates a country

  deprecated

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/country#get-countries)

  [/admin/api/latest/countries.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/country#get-countries)

  Retrieves a list of countries

  deprecated

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/country#get-countries-country-id)

  [/admin/api/latest/countries/{country\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/country#get-countries-country-id)

  Retrieves a specific country

  deprecated

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/country#get-countries-count)

  [/admin/api/latest/countries/count.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/country#get-countries-count)

  Retrieves a count of countries

  deprecated

* [put](https://shopify.dev/docs/api/admin-rest/latest/resources/country#put-countries-country-id)

  [/admin/api/latest/countries/{country\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/country#put-countries-country-id)

  Updates an existing country

  deprecated

* [del](https://shopify.dev/docs/api/admin-rest/latest/resources/country#delete-countries-country-id)

  [/admin/api/latest/countries/{country\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/country#delete-countries-country-id)

  Deletes a country

  deprecated

***

## The Country resource

### Properties

***

code

deprecated

The two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format).

***

id

deprecated

The ID for the country. The ID for a country is unique across all Shopify stores. The ID for a country in one shop will be different from the same country in another shop.

***

name

deprecated

The full name of the country in English.

***

provinces

deprecated

The sub-regions of a country, such as its provinces or states. Each sub-region has the following properties:

Show provinces properties

* **code**: The two letter province or state code.
* **country\_id**: The ID for the country to which this sub-region belongs.
* **id**: The ID for the particular sub-region.
* **name**: The name of the sub-region.
* **tax**: The tax value in decimal format.
* **tax\_name**: The name of the tax as it is referred to in the applicable sub-region. For example, in Canada, the sales tax in the province Ontario is referred to as HST.
* **tax\_type**: The tax type. Valid values: `null`, `normal`, or `harmonized`. If the value is `harmonized`, then the tax is compounded of the provincial and federal sales taxes.
* **tax\_percentage**: The tax value in percent format.

***

tax

deprecated

The national sales tax rate applied to orders made by customers from that country.

***

{}

## The Country resource

```json
{
  "code": "CA",
  "id": 879921427,
  "name": "Canada",
  "provinces": [
    {
      "code": "ON",
      "country_id": 879921427,
      "id": 205434194,
      "name": "Ontario",
      "tax": 0.13,
      "tax_name": "HST",
      "tax_type": "harmonized",
      "tax_percentage": 13
    }
  ],
  "tax": 0.05
}
```

***

## postCreates a countrydeprecated

Requires `shipping` access scope.

Important

This endpoint is deprecated as of 2024-07.

Caution

As of version 2020-10, the tax field is deprecated.

Creates a country.

### Parameters

***

api\_version

string

required

***

### Examples

Create a country using Shopify's tax rate for it

Request body

country​

Country resource

Show country properties

country.code:​"FR"

deprecated

The two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format).

Create a country using a custom tax rate

Request body

country​

Country resource

Show country properties

country.code:​"FR"

deprecated

The two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format).

country.tax:​0.2

deprecated

The national sales tax rate applied to orders made by customers from that country.

post

## /admin/api/2025-10/countries.​json

```bash
curl -d '{"country":{"code":"FR"}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/countries.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```

{}

## Response

JSON

```json
HTTP/1.1 201 Created
{
  "country": {
    "id": 980881732,
    "name": "France",
    "code": "FR",
    "tax_name": "TVA",
    "tax": 0.2,
    "provinces": []
  }
}
```

### examples

* #### Create a country using Shopify's tax rate for it

  #####

  ```curl
  curl -d '{"country":{"code":"FR"}}' \
  -X POST "https://your-development-store.myshopify.com/admin/api/2025-10/countries.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #####

  ```remix
  const { admin, session } = await authenticate.admin(request);

  const country = new admin.rest.resources.Country({session: session});

  country.code = "FR";
  await country.save({
    update: true,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  country = ShopifyAPI::Country.new(session: test_session)
  country.code = "FR"
  country.save!
  ```

  #####

  ```node
  // Session is built by the OAuth process

  const country = new shopify.rest.Country({session: session});
  country.code = "FR";
  await country.save({
    update: true,
  });
  ```

  #### response

  ```json
  HTTP/1.1 201 Created{"country":{"id":980881732,"name":"France","code":"FR","tax_name":"TVA","tax":0.2,"provinces":[]}}
  ```

* #### Create a country using a custom tax rate

  #####

  ```curl
  curl -d '{"country":{"code":"FR","tax":0.2}}' \
  -X POST "https://your-development-store.myshopify.com/admin/api/2025-10/countries.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #####

  ```remix
  const { admin, session } = await authenticate.admin(request);

  const country = new admin.rest.resources.Country({session: session});

  country.code = "FR";
  country.tax = 0.2;
  await country.save({
    update: true,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  country = ShopifyAPI::Country.new(session: test_session)
  country.code = "FR"
  country.tax = 0.2
  country.save!
  ```

  #####

  ```node
  // Session is built by the OAuth process

  const country = new shopify.rest.Country({session: session});
  country.code = "FR";
  country.tax = 0.2;
  await country.save({
    update: true,
  });
  ```

  #### response

  ```json
  HTTP/1.1 201 Created{"country":{"id":980881733,"name":"France","code":"FR","tax_name":"TVA","tax":0.2,"provinces":[]}}
  ```

***

## getRetrieves a list of countriesdeprecated

Important

This endpoint is deprecated as of version 2024-07.

Please see the [Countries in shipping zone API](https://shopify.dev/docs/api/admin-graphql/2024-01/objects/CountriesInShippingZones) for a GraphQL alternative.

Retrieves a list of countries.

### Parameters

***

api\_version

string

required

***

fields

Show only certain fields, specified by a comma-separated list of field names.

***

since\_id

Restrict results to after the specified ID.

***

### Examples

Retrieve all countries

Retrieve all countries after the specified ID

Query parameters

since\_​id=​359115488

Restrict results to after the specified ID.

get

## /admin/api/2025-10/countries.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/countries.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "countries": [
    {
      "id": 879921427,
      "name": "Canada",
      "code": "CA",
      "tax_name": "GST",
      "tax": 0.05,
      "provinces": [
        {
          "id": 205434194,
          "country_id": 879921427,
          "name": "Alberta",
          "code": "AB",
          "tax_name": null,
          "tax_type": null,
          "shipping_zone_id": null,
          "tax": 0.08,
          "tax_percentage": 8
        },
        {
          "id": 170405627,
          "country_id": 879921427,
          "name": "British Columbia",
          "code": "BC",
          "tax_name": null,
          "tax_type": null,
          "shipping_zone_id": null,
          "tax": 0.07,
          "tax_percentage": 7
        },
        {
          "id": 342345110,
          "country_id": 879921427,
          "name": "Manitoba",
```

### examples

* #### Retrieve all countries

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/countries.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.Country.all({
    session: session,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::Country.all(
    session: test_session,
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.Country.all({
    session: session,
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"countries":[{"id":879921427,"name":"Canada","code":"CA","tax_name":"GST","tax":0.05,"provinces":[{"id":205434194,"country_id":879921427,"name":"Alberta","code":"AB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.08,"tax_percentage":8.0},{"id":170405627,"country_id":879921427,"name":"British Columbia","code":"BC","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0},{"id":342345110,"country_id":879921427,"name":"Manitoba","code":"MB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0},{"id":92264567,"country_id":879921427,"name":"New Brunswick","code":"NB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":243284171,"country_id":879921427,"name":"Newfoundland","code":"NL","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":439598329,"country_id":879921427,"name":"Northwest Territories","code":"NT","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0},{"id":448070559,"country_id":879921427,"name":"Nova Scotia","code":"NS","tax_name":null,"tax_type":"harmonized","shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":670206421,"country_id":879921427,"name":"Nunavut","code":"NU","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0},{"id":702530425,"country_id":879921427,"name":"Ontario","code":"ON","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.08,"tax_percentage":8.0},{"id":570891722,"country_id":879921427,"name":"Prince Edward Island","code":"PE","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.1,"tax_percentage":10.0},{"id":224293623,"country_id":879921427,"name":"Quebec","code":"QC","tax_name":"HST","tax_type":"compounded","shipping_zone_id":null,"tax":0.09,"tax_percentage":9.0},{"id":473391800,"country_id":879921427,"name":"Saskatchewan","code":"SK","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.09,"tax_percentage":9.0},{"id":1005264686,"country_id":879921427,"name":"Yukon","code":"YT","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0}]},{"id":359115488,"name":"Colombia","code":"CO","tax_name":"VAT","tax":0.15,"provinces":[]},{"id":817138619,"name":"United States","code":"US","tax_name":"Federal Tax","tax":0.0,"provinces":[{"id":952629862,"country_id":817138619,"name":"California","code":"CA","tax_name":null,"tax_type":null,"shipping_zone_id":1039932365,"tax":0.05,"tax_percentage":5.0},{"id":222234158,"country_id":817138619,"name":"Kentucky","code":"KY","tax_name":null,"tax_type":null,"shipping_zone_id":1039932365,"tax":0.06,"tax_percentage":6.0},{"id":9350860,"country_id":817138619,"name":"Massachusetts","code":"MA","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.065,"tax_percentage":6.5},{"id":696485510,"country_id":817138619,"name":"Minnesota","code":"MN","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.065,"tax_percentage":6.5},{"id":753050225,"country_id":817138619,"name":"New Jersey","code":"NJ","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.06,"tax_percentage":6.0},{"id":1013111685,"country_id":817138619,"name":"New York","code":"NY","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.04,"tax_percentage":4.0},{"id":915134533,"country_id":817138619,"name":"Pennsylvania","code":"PA","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.05,"tax_percentage":5.0},{"id":591478044,"country_id":817138619,"name":"Rhode Island","code":"RI","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0}]}]}
  ```

* #### Retrieve all countries after the specified ID

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/countries.json?since_id=359115488" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.Country.all({
    session: session,
    since_id: "359115488",
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::Country.all(
    session: test_session,
    since_id: "359115488",
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.Country.all({
    session: session,
    since_id: "359115488",
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"countries":[{"id":817138619,"name":"United States","code":"US","tax_name":"Federal Tax","tax":0.0,"provinces":[{"id":952629862,"country_id":817138619,"name":"California","code":"CA","tax_name":null,"tax_type":null,"shipping_zone_id":1039932365,"tax":0.05,"tax_percentage":5.0},{"id":222234158,"country_id":817138619,"name":"Kentucky","code":"KY","tax_name":null,"tax_type":null,"shipping_zone_id":1039932365,"tax":0.06,"tax_percentage":6.0},{"id":9350860,"country_id":817138619,"name":"Massachusetts","code":"MA","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.065,"tax_percentage":6.5},{"id":696485510,"country_id":817138619,"name":"Minnesota","code":"MN","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.065,"tax_percentage":6.5},{"id":753050225,"country_id":817138619,"name":"New Jersey","code":"NJ","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.06,"tax_percentage":6.0},{"id":1013111685,"country_id":817138619,"name":"New York","code":"NY","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.04,"tax_percentage":4.0},{"id":915134533,"country_id":817138619,"name":"Pennsylvania","code":"PA","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.05,"tax_percentage":5.0},{"id":591478044,"country_id":817138619,"name":"Rhode Island","code":"RI","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0}]},{"id":879921427,"name":"Canada","code":"CA","tax_name":"GST","tax":0.05,"provinces":[{"id":205434194,"country_id":879921427,"name":"Alberta","code":"AB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.08,"tax_percentage":8.0},{"id":170405627,"country_id":879921427,"name":"British Columbia","code":"BC","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0},{"id":342345110,"country_id":879921427,"name":"Manitoba","code":"MB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0},{"id":92264567,"country_id":879921427,"name":"New Brunswick","code":"NB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":243284171,"country_id":879921427,"name":"Newfoundland","code":"NL","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":439598329,"country_id":879921427,"name":"Northwest Territories","code":"NT","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0},{"id":448070559,"country_id":879921427,"name":"Nova Scotia","code":"NS","tax_name":null,"tax_type":"harmonized","shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":670206421,"country_id":879921427,"name":"Nunavut","code":"NU","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0},{"id":702530425,"country_id":879921427,"name":"Ontario","code":"ON","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.08,"tax_percentage":8.0},{"id":570891722,"country_id":879921427,"name":"Prince Edward Island","code":"PE","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.1,"tax_percentage":10.0},{"id":224293623,"country_id":879921427,"name":"Quebec","code":"QC","tax_name":"HST","tax_type":"compounded","shipping_zone_id":null,"tax":0.09,"tax_percentage":9.0},{"id":473391800,"country_id":879921427,"name":"Saskatchewan","code":"SK","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.09,"tax_percentage":9.0},{"id":1005264686,"country_id":879921427,"name":"Yukon","code":"YT","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0}]}]}
  ```

***

## getRetrieves a specific countrydeprecated

Important

This endpoint is deprecated as of version 2024-07.

Please see the [Countries in shipping zone API](https://shopify.dev/docs/api/admin-graphql/2024-01/objects/CountriesInShippingZones) for a GraphQL alternative.

Retrieves a specific country

### Parameters

***

api\_version

string

required

***

country\_id

string

required

***

fields

Show only certain fields, specified by a comma-separated list of field names.

***

### Examples

Retrieve a specific country by its ID

Path parameters

country\_​id=​879921427

string

required

get

## /admin/api/2025-10/countries/879921427.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/countries/879921427.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "country": {
    "id": 879921427,
    "name": "Canada",
    "code": "CA",
    "tax_name": "GST",
    "tax": 0.05,
    "provinces": [
      {
        "id": 205434194,
        "country_id": 879921427,
        "name": "Alberta",
        "code": "AB",
        "tax_name": null,
        "tax_type": null,
        "shipping_zone_id": null,
        "tax": 0.08,
        "tax_percentage": 8
      },
      {
        "id": 170405627,
        "country_id": 879921427,
        "name": "British Columbia",
        "code": "BC",
        "tax_name": null,
        "tax_type": null,
        "shipping_zone_id": null,
        "tax": 0.07,
        "tax_percentage": 7
      },
      {
        "id": 342345110,
        "country_id": 879921427,
        "name": "Manitoba",
        "code": "MB",
```

### examples

* #### Retrieve a specific country by its ID

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/countries/879921427.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.Country.find({
    session: session,
    id: 879921427,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::Country.find(
    session: test_session,
    id: 879921427,
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.Country.find({
    session: session,
    id: 879921427,
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"country":{"id":879921427,"name":"Canada","code":"CA","tax_name":"GST","tax":0.05,"provinces":[{"id":205434194,"country_id":879921427,"name":"Alberta","code":"AB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.08,"tax_percentage":8.0},{"id":170405627,"country_id":879921427,"name":"British Columbia","code":"BC","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0},{"id":342345110,"country_id":879921427,"name":"Manitoba","code":"MB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0},{"id":92264567,"country_id":879921427,"name":"New Brunswick","code":"NB","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":243284171,"country_id":879921427,"name":"Newfoundland","code":"NL","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":439598329,"country_id":879921427,"name":"Northwest Territories","code":"NT","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0},{"id":448070559,"country_id":879921427,"name":"Nova Scotia","code":"NS","tax_name":null,"tax_type":"harmonized","shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"id":670206421,"country_id":879921427,"name":"Nunavut","code":"NU","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0},{"id":702530425,"country_id":879921427,"name":"Ontario","code":"ON","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.08,"tax_percentage":8.0},{"id":570891722,"country_id":879921427,"name":"Prince Edward Island","code":"PE","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.1,"tax_percentage":10.0},{"id":224293623,"country_id":879921427,"name":"Quebec","code":"QC","tax_name":"HST","tax_type":"compounded","shipping_zone_id":null,"tax":0.09,"tax_percentage":9.0},{"id":473391800,"country_id":879921427,"name":"Saskatchewan","code":"SK","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.09,"tax_percentage":9.0},{"id":1005264686,"country_id":879921427,"name":"Yukon","code":"YT","tax_name":null,"tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0}]}}
  ```

***

## getRetrieves a count of countriesdeprecated

Important

This endpoint is deprecated as of 2024-07.

Please see the [Countries in shipping zone API](https://shopify.dev/docs/api/admin-graphql/2024-01/objects/CountriesInShippingZones) for a GraphQL alternative.

Retrieves a count of countries.

### Parameters

***

api\_version

string

required

***

### Examples

Count all countries

get

## /admin/api/2025-10/countries/count.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/countries/count.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "count": 3
}
```

### examples

* #### Count all countries

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/countries/count.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.Country.count({
    session: session,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::Country.count(
    session: test_session,
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.Country.count({
    session: session,
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"count":3}
  ```

***

## putUpdates an existing countrydeprecated

Requires `shipping` access scope.

Important

This endpoint is deprecated as of 2024-07.

Please see the [Countries in shipping zone API](https://shopify.dev/docs/api/admin-graphql/2024-01/objects/CountriesInShippingZones) for a GraphQL alternative.

Caution

As of version 2020-10, the tax field is deprecated.

Updates an existing country.

### Parameters

***

api\_version

string

required

***

country\_id

string

required

***

### Examples

Update a country's tax rate

Path parameters

country\_​id=​879921427

string

required

Request body

country​

Country resource

Show country properties

country.id:​879921427

deprecated

The ID for the country. The ID for a country is unique across all Shopify stores. The ID for a country in one shop will be different from the same country in another shop.

country.tax:​0.05

deprecated

The national sales tax rate applied to orders made by customers from that country.

put

## /admin/api/2025-10/countries/879921427.​json

```bash
curl -d '{"country":{"id":879921427,"tax":0.05}}' \
-X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/countries/879921427.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "country": {
    "id": 879921427,
    "name": "Canada",
    "code": "CA",
    "tax_name": "GST",
    "tax": 0.05,
    "provinces": [
      {
        "country_id": 879921427,
        "tax_name": "Tax",
        "id": 205434194,
        "name": "Alberta",
        "code": "AB",
        "tax_type": null,
        "shipping_zone_id": null,
        "tax": 0.08,
        "tax_percentage": 8
      },
      {
        "country_id": 879921427,
        "tax_name": "Tax",
        "id": 170405627,
        "name": "British Columbia",
        "code": "BC",
        "tax_type": null,
        "shipping_zone_id": null,
        "tax": 0.07,
        "tax_percentage": 7
      },
      {
        "country_id": 879921427,
        "tax_name": "Tax",
        "id": 342345110,
        "name": "Manitoba",
```

### examples

* #### Update a country's tax rate

  #####

  ```curl
  curl -d '{"country":{"id":879921427,"tax":0.05}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/countries/879921427.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #####

  ```remix
  const { admin, session } = await authenticate.admin(request);

  const country = new admin.rest.resources.Country({session: session});

  country.id = 879921427;
  country.tax = 0.05;
  await country.save({
    update: true,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  country = ShopifyAPI::Country.new(session: test_session)
  country.id = 879921427
  country.tax = 0.05
  country.save!
  ```

  #####

  ```node
  // Session is built by the OAuth process

  const country = new shopify.rest.Country({session: session});
  country.id = 879921427;
  country.tax = 0.05;
  await country.save({
    update: true,
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"country":{"id":879921427,"name":"Canada","code":"CA","tax_name":"GST","tax":0.05,"provinces":[{"country_id":879921427,"tax_name":"Tax","id":205434194,"name":"Alberta","code":"AB","tax_type":null,"shipping_zone_id":null,"tax":0.08,"tax_percentage":8.0},{"country_id":879921427,"tax_name":"Tax","id":170405627,"name":"British Columbia","code":"BC","tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0},{"country_id":879921427,"tax_name":"Tax","id":342345110,"name":"Manitoba","code":"MB","tax_type":null,"shipping_zone_id":null,"tax":0.07,"tax_percentage":7.0},{"country_id":879921427,"tax_name":"Tax","id":92264567,"name":"New Brunswick","code":"NB","tax_type":null,"shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"country_id":879921427,"tax_name":"Tax","id":243284171,"name":"Newfoundland","code":"NL","tax_type":null,"shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"country_id":879921427,"tax_name":"Tax","id":439598329,"name":"Northwest Territories","code":"NT","tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0},{"country_id":879921427,"tax_name":"Tax","id":448070559,"name":"Nova Scotia","code":"NS","tax_type":"harmonized","shipping_zone_id":null,"tax":0.15,"tax_percentage":15.0},{"country_id":879921427,"tax_name":"Tax","id":670206421,"name":"Nunavut","code":"NU","tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0},{"country_id":879921427,"tax_name":"Tax","id":702530425,"name":"Ontario","code":"ON","tax_type":null,"shipping_zone_id":null,"tax":0.08,"tax_percentage":8.0},{"country_id":879921427,"tax_name":"Tax","id":570891722,"name":"Prince Edward Island","code":"PE","tax_type":null,"shipping_zone_id":null,"tax":0.1,"tax_percentage":10.0},{"id":224293623,"country_id":879921427,"name":"Quebec","code":"QC","tax_name":"HST","tax_type":"compounded","shipping_zone_id":null,"tax":0.09,"tax_percentage":9.0},{"country_id":879921427,"tax_name":"Tax","id":473391800,"name":"Saskatchewan","code":"SK","tax_type":null,"shipping_zone_id":null,"tax":0.09,"tax_percentage":9.0},{"country_id":879921427,"tax_name":"Tax","id":1005264686,"name":"Yukon","code":"YT","tax_type":null,"shipping_zone_id":null,"tax":0.0,"tax_percentage":0.0}]}}
  ```

***

## delDeletes a countrydeprecated

Requires `shipping` access scope.

Important

This endpoint is deprecated as of version 2024-07.

### Parameters

***

api\_version

string

required

***

country\_id

string

required

***

### Examples

Delete a country

Path parameters

country\_​id=​879921427

string

required

del

## /admin/api/2025-10/countries/879921427.​json

```bash
curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2025-10/countries/879921427.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{}
```

### examples

* #### Delete a country

  #####

  ```curl
  curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2025-10/countries/879921427.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.Country.delete({
    session: session,
    id: 879921427,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::Country.delete(
    session: test_session,
    id: 879921427,
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.Country.delete({
    session: session,
    id: 879921427,
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{}
  ```