GET

/admin/api/2026-07/zones.json

List every zone on the shop, optionally filtered by publish status.

Try it

Parameters

statusstring, optionalFilter by zone status. One of `draft`, `published`, `archived`. Omit to return all statuses.

limitinteger, optionalNumber of zones to return per page. Default 50, maximum 250.

page_infostring, optionalCursor from the `Link` response header, used to fetch the next or previous page.

Error responses

401UNAUTHORIZEDThe request is missing a valid X-Shopify-Access-Token header.

403MISSING_SCOPEThe access token does not have the read_shipping scope.

429RATE_LIMITEDThe shop's Admin API call limit has been reached. Retry after the Retry-After header.

Request body

{
  "zones": [
    {
      "id": 918273645,
      "name": "Downtown same-day",
      "status": "published",
      "coverage_type": "radius",
      "created_at": "2026-04-02T09:14:00-04:00"
    }
  ]
}

Response 201

{
  "zones": [
    {
      "id": 918273645,
      "name": "Downtown same-day",
      "status": "published",
      "coverage_type": "radius",
      "created_at": "2026-04-02T09:14:00-04:00"
    }
  ]
}

curl "https://{shop}.myshopify.com/admin/api/2026-07/zones.json?status=published" \
  -H "X-Shopify-Access-Token: {access_token}"

session = ShopifyAPI::Auth::Session.new(shop: shop, access_token: token)
client = ShopifyAPI::Clients::Rest::Admin.new(session: session)
response = client.get(path: "zones", query: { status: "published" })
puts response.body["zones"]

const response = await fetch(
  `https://${shop}/admin/api/2026-07/zones.json?status=published`,
  { headers: { 'X-Shopify-Access-Token': accessToken } },
);
const { zones } = await response.json();