Shopify

Shopify Versions API

The Versions API from Shopify — 26 operation(s) for versions.

Documentation GitHub OpenAPI

Operations 18

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /admin/api/2020-01/countries.json Add a country to the store (2020-01) · Shopify As Of Version 2020-10 #

Ask an LLM

“Can I add a new country to my store settings with the 2020-01 Admin API?”

“What 2020-01 call creates a country record for the shop?”

Tell an agent

Add a country to my store using API version 2020-01.

Create a country entry through the 2020-01 countries endpoint.

PUT /admin/api/2020-01/countries/{country_id}.json Update a store country (2020-01) · Shopify As Of Version 2020-10 #

Ask an LLM

“How do I edit one of my store's countries on 2020-01?”

“Which 2020-01 endpoint changes an existing country's settings?”

Tell an agent

Update country {country} using API version 2020-01.

Save changes to the store's country {country} via the 2020-01 API.

POST /admin/api/2020-04/countries.json Add a country to the store (2020-04) · Shopify As Of Version 2020-10 #

Ask an LLM

“Which 2020-04 endpoint adds a country to the shop?”

“Is creating a country still possible on version 2020-04?”

Tell an agent

Create a new country for the store through the 2020-04 API.

Register another country in my shop with version 2020-04.

PUT /admin/api/2020-04/countries/{country_id}.json Update a store country (2020-04) · Shopify As Of Version 2020-10 #

Ask an LLM

“What 2020-04 call modifies a country I already set up?”

“Can I change a country record by its ID on version 2020-04?”

Tell an agent

Modify country {country} through the 2020-04 API.

Edit store country {country} with version 2020-04.

POST /admin/api/2020-07/countries.json Add a country to the store (2020-07) · Shopify As Of Version 2020-10 #

Ask an LLM

“What 2020-07 endpoint creates a country for my shop?”

“Does the 2020-07 release let me add countries to the store?”

Tell an agent

Add a country with the 2020-07 Admin API.

Set up a new store country via version 2020-07.

PUT /admin/api/2020-07/countries/{country_id}.json Update a store country (2020-07) · Shopify As Of Version 2020-10 #

Ask an LLM

“Is updating a country supported in 2020-07?”

“Which endpoint in 2020-07 edits a country by ID?”

Tell an agent

Edit country {country} using version 2020-07.

Apply updates to the shop's country {country} via the 2020-07 Admin API.

POST /admin/api/2020-10/countries.json Add a country to the store (2020-10) · Shopify As Of Version 2020-10 #

Ask an LLM

“How can I add a country to my Shopify store on version 2020-10?”

“Which 2020-10 call creates a new country record?”

Tell an agent

Create a country on 2020-10.

Add a new country to the shop using the 2020-10 endpoint.

PUT /admin/api/2020-10/countries/{country_id}.json Update a store country (2020-10) · Shopify As Of Version 2020-10 #

Ask an LLM

“How can I update a country in the 2020-10 release?”

“What 2020-10 endpoint rewrites an existing country's details?”

Tell an agent

Update country {country} on 2020-10.

Change the details of store country {country} via version 2020-10.

POST /admin/api/2021-01/countries.json Add a country to the store (2021-01) · Shopify As Of Version 2020-10 #

Ask an LLM

“Can I create a country through the 2021-01 API?”

“Where do I add a store country in version 2021-01?”

Tell an agent

Set up a country with the 2021-01 release.

Create a store country on API version 2021-01.

PUT /admin/api/2021-01/countries/{country_id}.json Update a store country (2021-01) · Shopify As Of Version 2020-10 #

Ask an LLM

“Can the 2021-01 API change an existing country?”

“Where do I update a country record in version 2021-01?”

Tell an agent

Modify country {country} with the 2021-01 release.

Push edits to store country {country} using 2021-01.

POST /admin/api/unstable/countries.json Add a country to the store (unstable) · Shopify As Of Version 2020-10 #

Ask an LLM

“Does the unstable API let me add a country?”

“What's the unstable-version call for creating a country?”

Tell an agent

Create a country using the unstable version.

Add a store country through the unstable Admin API.

PUT /admin/api/unstable/countries/{country_id}.json Update a store country (unstable) · Shopify As Of Version 2020-10 #

Ask an LLM

“Does the unstable version support editing a country?”

“What's the unstable call for updating a country by ID?”

Tell an agent

Update country {country} on the unstable API.

Edit the existing store country {country} via the unstable version.

PUT /admin/api/2020-01/countries/{country_id}/provinces/{province_id}.json Update a province of a country (2020-01) · Shopify As Of Version 2020-10 #

Ask an LLM

“Can I edit a province or state within a country using the 2020-01 API?”

“What 2020-01 call changes a single province's settings?”

Tell an agent

Update province {province} of country {country} using API version 2020-01.

Save changes to region {province} under country {country} with the 2020-01 API.

PUT /admin/api/2020-04/countries/{country_id}/provinces/{province_id}.json Update a province of a country (2020-04) · Shopify As Of Version 2020-10 #

Ask an LLM

“Which 2020-04 endpoint modifies a province of a country?”

“Is updating a state or province possible on version 2020-04?”

Tell an agent

Modify province {province} in country {country} through the 2020-04 API.

Edit the {province} province of country {country} with 2020-04.

PUT /admin/api/2020-07/countries/{country_id}/provinces/{province_id}.json Update a province of a country (2020-07) · Shopify As Of Version 2020-10 #

Ask an LLM

“What 2020-07 call edits a province belonging to a country?”

“Can I change one state's record within a country on 2020-07?”

Tell an agent

Edit province {province} of country {country} using version 2020-07.

Apply updates to province {province} in country {country} via the 2020-07 Admin API.

PUT /admin/api/2020-10/countries/{country_id}/provinces/{province_id}.json Update a province of a country (2020-10) · Shopify As Of Version 2020-10 #

Ask an LLM

“How can I update a province in one of my countries on 2020-10?”

“Which 2020-10 endpoint rewrites a state or province record?”

Tell an agent

Update province {province} of country {country} on 2020-10.

Change the settings of province {province} within country {country} via version 2020-10.

PUT /admin/api/2021-01/countries/{country_id}/provinces/{province_id}.json Update a province of a country (2021-01) · Shopify As Of Version 2020-10 #

Ask an LLM

“Can the 2021-01 API change a province inside a country?”

“Where do I edit a state or province in version 2021-01?”

Tell an agent

Modify province {province} of country {country} with the 2021-01 release.

Push edits to province {province} in country {country} using 2021-01.

PUT /admin/api/unstable/countries/{country_id}/provinces/{province_id}.json Update a province of a country (unstable) · Shopify As Of Version 2020-10 #

Ask an LLM

“Does the unstable version support editing a province?”

“What's the unstable call for updating a state within a country?”

Tell an agent

Update province {province} of country {country} on the unstable API.

Edit province {province} under country {country} via the unstable version.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/shopify-versions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Shopify Versions API
  description: Explore Shopify's API reference and templating documentation. Shopify provides a range of software tools, app templates, example apps, and libraries to accelerate your development process. The Admin API lets you build apps and integrations that extend and enhance the Shopify admin.
  version: 2020-10
tags:
- name: Versions
paths:
  /admin/api/2020-01/countries.json:
    post:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    code: FR
                summary: Create a country using Shopify's tax rate for it
              example2:
                value:
                  country:
                    code: FR
                    tax: 0.2
                summary: Create a country using a custom tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#create-2020-01
      parameters: []
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_create_countries
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/countries/{country_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    id: 879921427
                    tax: 0.05
                summary: Update a country's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#update-2020-01
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_update_countries_param_country_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/countries.json:
    post:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    code: FR
                summary: Create a country using Shopify's tax rate for it
              example2:
                value:
                  country:
                    code: FR
                    tax: 0.2
                summary: Create a country using a custom tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#create-2020-04
      parameters: []
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_create_countries
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/countries/{country_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    id: 879921427
                    tax: 0.05
                summary: Update a country's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#update-2020-04
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_update_countries_param_country_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/countries.json:
    post:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    code: FR
                summary: Create a country using Shopify's tax rate for it
              example2:
                value:
                  country:
                    code: FR
                    tax: 0.2
                summary: Create a country using a custom tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#create-2020-07
      parameters: []
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_create_countries
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/countries/{country_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    id: 879921427
                    tax: 0.05
                summary: Update a country's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#update-2020-07
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_update_countries_param_country_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-10/countries.json:
    post:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    code: FR
                summary: Create a country using Shopify's tax rate for it
              example2:
                value:
                  country:
                    code: FR
                    tax: 0.2
                summary: Create a country using a custom tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#create-2020-10
      parameters: []
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: create_countries
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-10/countries/{country_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    id: 879921427
                    tax: 0.05
                summary: Update a country's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#update-2020-10
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: update_countries_param_country_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2021-01/countries.json:
    post:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    code: FR
                summary: Create a country using Shopify's tax rate for it
              example2:
                value:
                  country:
                    code: FR
                    tax: 0.2
                summary: Create a country using a custom tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#create-2021-01
      parameters: []
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202101_create_countries
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2021-01/countries/{country_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    id: 879921427
                    tax: 0.05
                summary: Update a country's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#update-2021-01
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202101_update_countries_param_country_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/unstable/countries.json:
    post:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    code: FR
                summary: Create a country using Shopify's tax rate for it
              example2:
                value:
                  country:
                    code: FR
                    tax: 0.2
                summary: Create a country using a custom tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#create-unstable
      parameters: []
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_unstable_create_countries
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/unstable/countries/{country_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  country:
                    id: 879921427
                    tax: 0.05
                summary: Update a country's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/country#update-unstable
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_unstable_update_countries_param_country_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/countries/{country_id}/provinces/{province_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  province:
                    id: 224293623
                    tax: 0.09
                summary: Update a province's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/province#update-2020-01
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      - in: path
        name: province_id
        required: true
        schema:
          type: string
        description: province_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_update_countries_param_country_id_provinces_param_province_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/countries/{country_id}/provinces/{province_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  province:
                    id: 224293623
                    tax: 0.09
                summary: Update a province's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/province#update-2020-04
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      - in: path
        name: province_id
        required: true
        schema:
          type: string
        description: province_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_update_countries_param_country_id_provinces_param_province_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/countries/{country_id}/provinces/{province_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  province:
                    id: 224293623
                    tax: 0.09
                summary: Update a province's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/province#update-2020-07
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      - in: path
        name: province_id
        required: true
        schema:
          type: string
        description: province_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_update_countries_param_country_id_provinces_param_province_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-10/countries/{country_id}/provinces/{province_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  province:
                    id: 224293623
                    tax: 0.09
                summary: Update a province's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/province#update-2020-10
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      - in: path
        name: province_id
        required: true
        schema:
          type: string
        description: province_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: update_countries_param_country_id_provinces_param_province_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2021-01/countries/{country_id}/provinces/{province_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  province:
                    id: 224293623
                    tax: 0.09
                summary: Update a province's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/province#update-2021-01
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      - in: path
        name: province_id
        required: true
        schema:
          type: string
        description: province_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_202101_update_countries_param_country_id_provinces_param_province_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/unstable/countries/{country_id}/provinces/{province_id}.json:
    put:
      requestBody:
        content:
          application/json:
            schema: {}
            examples:
              example1:
                value:
                  province:
                    id: 224293623
                    tax: 0.09
                summary: Update a province's tax rate
      summary: Shopify As Of Version 2020-10
      description: https://shopify.dev/docs/admin-api/rest/reference/store-properties/province#update-unstable
      parameters:
      - in: path
        name: country_id
        required: true
        schema:
          type: string
        description: country_id
      - in: path
        name: province_id
        required: true
        schema:
          type: string
        description: province_id
      tags:
      - Versions
      responses:
        '200':
          description: ''
      operationId: deprecated_unstable_update_countries_param_country_id_provinces_param_province_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true

Shopify Versions API

Operations 18

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification