The REST Admin API is a legacy API as of October 1, 2024. All apps and integrations should be built with the GraphQL Admin API. For details and migration steps, visit our migration guide.
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 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.
Caution
As of version 2020-10, you can no longer create or update custom tax values for the Country resource.
The sub-regions of a country, such as its provinces or states. Each sub-region has the following properties:
Requires shipping
access scope.
Important
This endpoint is deprecated as of 2024-07.
Important
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.
Important
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
Important
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.
Requires shipping
access scope.
Important
This endpoint is deprecated as of 2024-07.
Please see the Countries in shipping zone API for a GraphQL alternative.
Requires shipping
access scope.
Important
This endpoint is deprecated as of version 2024-07.