---
title: "Deprecation Notice: Country and Province Endpoints in Admin REST API - Shopify developer changelog"
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/deprecation-notice-country-and-province-endpoints-in-admin-rest-api
  md: https://shopify.dev/changelog/deprecation-notice-country-and-province-endpoints-in-admin-rest-api.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

July 1, 2024

Tags:

* Action Required
* Admin REST API
* 2024-07

# Deprecation Notice: Country and Province Endpoints in Admin REST API

# Changelog: Deprecation Notice for Country and Province Endpoints

**Version:** 2024-07

***

We are deprecating all endpoints in the Country and Province sets of our REST API. Please review the changes below:

## Deprecated Country Endpoints

Effective version 2024-07, the following [Country endpoints](https://shopify.dev/docs/api/admin-rest/latest/resources/country) will be deprecated:

* **POST** `/admin/api/<version>/countries.json`
* **GET** `/admin/api/<version>/countries.json`
* **GET** `/admin/api/<version>/countries/{country_id}.json`
* **GET** `/admin/api/<version>/countries/count.json`
* **PUT** `/admin/api/<version>/countries/{country_id}.json`
* **DELETE** `/admin/api/<version>/countries/{country_id}.json`

### Replacement for Listing All Countries

Use the Storefront API endpoint to list all countries:

* **GET** [Localization Available Countries](https://shopify.dev/docs/api/storefront/2024-04/objects/Localization#field-localization-availablecountries)

## Deprecated Province Endpoints

Effective version 2024-07, the following [Province endpoints](https://shopify.dev/docs/api/admin-rest/latest/resources/province) will be deprecated:

* **GET** `/admin/api/<version>/countries/{country_id}/provinces.json`
* **GET** `/admin/api/<version>/countries/{country_id}/provinces/{province_id}.json`
* **GET** `/admin/api/<version>/countries/{country_id}/provinces/count.json`
* **PUT** `/admin/api/<version>/countries/{country_id}/provinces/{province_id}.json`

### No Replacements for Province Endpoints

There are no replacements for the Province endpoints. Please adjust your integrations accordingly.

## Action Required

Update your applications to accommodate these changes before the deprecation date. For listing countries, transition to [the recommended Storefront GraphQL API endpoint](https://shopify.dev/docs/api/storefront/2024-04/objects/Localization#field-localization-availablecountries).

To setup the Storefront API, you can view our [documentation for more information](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started).

For questions or assistance, contact our support team.