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. For details and migration steps, visit our migration guide.
Country
The REST Country API is deprecated as of version 2024-07.
Please refer to the documentation for each individual endpoint and the developer changelog for more information.
The Country resource represents the tax rates applied to orders from the different countries where a shop sells its products.
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 resource.
As of version 2020-10, you can no longer create or update custom tax values for the Country resource.
Endpoints
- post/admin/api/latest/countries.
json Creates a countrydeprecated - get/admin/api/latest/countries.
json Retrieves a list of countriesdeprecated - get/admin/api/latest/countries/{country_
id}. json Retrieves a specific countrydeprecated - get/admin/api/latest/countries/count.
json Retrieves a count of countriesdeprecated - put/admin/api/latest/countries/{country_
id}. json Updates an existing countrydeprecated - del/admin/api/latest/countries/{country_
id}. json Deletes a countrydeprecated
The Country resource
Properties
The two-letter country code (ISO 3166-1 alpha-2 format).
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.
The full name of the country in English.
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, orharmonized. If the value isharmonized, then the tax is compounded of the provincial and federal sales taxes. - tax_percentage: The tax value in percent format.
The national sales tax rate applied to orders made by customers from that country.
The Country resource
Anchor to POST request, Creates a countrypostCreates a country deprecated
shipping access scope.This endpoint is deprecated as of 2024-07.
As of version 2020-10, the tax field is deprecated.
Create a country using Shopify's tax rate for it
Create a country using Shopify's tax rate for it
Show country properties
The two-letter country code (ISO 3166-1 alpha-2 format).
Create a country using a custom tax rate
Create a country using a custom tax rate
Show country properties
The two-letter country code (ISO 3166-1 alpha-2 format).
The national sales tax rate applied to orders made by customers from that country.
/admin/api/2025-07/countries.
Response
Anchor to GET request, Retrieves a list of countriesgetRetrieves a list of countries deprecated
This endpoint is deprecated as of version 2024-07.
Please see the Countries in shipping zone API for a GraphQL alternative.
Retrieves a list of countries.
Show only certain fields, specified by a comma-separated list of field names.
Restrict results to after the specified ID.
Anchor to get-countries-examplesExamples
Retrieve all countries
Retrieve all countries
Retrieve all countries after the specified ID
Retrieve all countries after the specified ID
Restrict results to after the specified ID.
/admin/api/2025-07/countries.
Response
Anchor to GET request, Retrieves a specific countrygetRetrieves a specific country deprecated
This endpoint is deprecated as of version 2024-07.
Please see the Countries in shipping zone API for a GraphQL alternative.
Retrieves a specific country
Show only certain fields, specified by a comma-separated list of field names.
Retrieve a specific country by its ID
Retrieve a specific country by its ID
/admin/api/2025-07/countries/879921427.
Response
Anchor to GET request, Retrieves a count of countriesgetRetrieves a count of countries deprecated
This endpoint is deprecated as of 2024-07.
Please see the Countries in shipping zone API for a GraphQL alternative.
Retrieves a count of countries.
Count all countries
Count all countries
/admin/api/2025-07/countries/count.
Response
Anchor to PUT request, Updates an existing countryputUpdates an existing country deprecated
shipping access scope.This endpoint is deprecated as of 2024-07.
Please see the Countries in shipping zone API for a GraphQL alternative.
As of version 2020-10, the tax field is deprecated.
Update a country's tax rate
Update a country's tax rate
Show country properties
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.
The national sales tax rate applied to orders made by customers from that country.
/admin/api/2025-07/countries/879921427.
Response
Anchor to DELETE request, Deletes a countrydelDeletes a country deprecated
shipping access scope.This endpoint is deprecated as of version 2024-07.
Delete a country
Delete a country