How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Shopify Discount API

The Discount API from Shopify — 36 operation(s) for discount.

Shopify Discount API is one of 213 APIs that Shopify publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Discount. The published artifact set on APIs.io includes an OpenAPI specification, a JSON-LD context, API documentation, an API reference, and 8 JSON Schemas.

This API exposes 54 operations across 36 paths. It is described by OpenAPI 3.2.0, at version 2025-01.

Requests are made against a single base URL, https://{store}.myshopify.com/admin/api/2025-01.

54 operations 36 paths 0 schemas 6 DELETE30 GET12 POST6 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2025-01
Server
https://{store}.myshopify.com/admin/api/2025-01
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

Shopify Discount API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Shopify-Access-Token (AccessToken). By default, every request must be authenticated.

  • AccessToken — Access token obtained via OAuth

Paths & Operations 54

Across 36 paths, the API surfaces 54 operations — 6 DELETE, 30 GET, 12 POST, 6 PUT. Each is listed below with its method, path, parameters, and response codes.

Discount 54
POST
/admin/api/2020-01/price_rules/{price_rule_id}/discount_codes.json
Shopify Creates A Discount Code
deprecated_202001_create_price_rules_param_price_rule_id_discount_codes 1 param body → 200
GET
/admin/api/2020-01/price_rules/{price_rule_id}/discount_codes.json
Shopify Retrieve A List Of Discount Codes
deprecated_202001_get_price_rules_param_price_rule_id_discount_codes 1 param → 200
PUT
/admin/api/2020-01/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Updates An Existing Discount Code
deprecated_202001_update_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params body → 200
GET
/admin/api/2020-01/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Retrieves A Single Discount Code
deprecated_202001_get_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
DELETE
/admin/api/2020-01/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Deletes A Discount Code
deprecated_202001_delete_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
GET
/admin/api/2020-01/discount_codes/lookup.json
Shopify Retrieves The Location Of A Discount Code
deprecated_202001_get_discount_codes_lookup 1 param → 200
POST
/admin/api/2020-01/price_rules/{price_rule_id}/batch.json
Shopify Creates A Discount Code Creation Job
deprecated_202001_create_price_rules_param_price_rule_id_batch 1 param body → 200
GET
/admin/api/2020-01/price_rules/{price_rule_id}/batch/{batch_id}.json
Shopify Retrieves A Discount Code Creation Job
deprecated_202001_get_price_rules_param_price_rule_id_batch_param_batch_id 2 params → 200
GET
/admin/api/2020-01/price_rules/{price_rule_id}/batch/{batch_id}/discount_codes.json
Shopify Retrieves A List Of Discount Codes For A Discount Code Creation Job
deprecated_202001_get_price_rules_param_price_rule_id_batch_param_batch_id_discount_codes 2 params → 200
POST
/admin/api/2020-04/price_rules/{price_rule_id}/discount_codes.json
Shopify Creates A Discount Code
deprecated_202004_create_price_rules_param_price_rule_id_discount_codes 1 param body → 200
GET
/admin/api/2020-04/price_rules/{price_rule_id}/discount_codes.json
Shopify Retrieve A List Of Discount Codes
deprecated_202004_get_price_rules_param_price_rule_id_discount_codes 1 param → 200
PUT
/admin/api/2020-04/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Updates An Existing Discount Code
deprecated_202004_update_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params body → 200
GET
/admin/api/2020-04/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Retrieves A Single Discount Code
deprecated_202004_get_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
DELETE
/admin/api/2020-04/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Deletes A Discount Code
deprecated_202004_delete_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
GET
/admin/api/2020-04/discount_codes/lookup.json
Shopify Retrieves The Location Of A Discount Code
deprecated_202004_get_discount_codes_lookup 1 param → 200
POST
/admin/api/2020-04/price_rules/{price_rule_id}/batch.json
Shopify Creates A Discount Code Creation Job
deprecated_202004_create_price_rules_param_price_rule_id_batch 1 param body → 200
GET
/admin/api/2020-04/price_rules/{price_rule_id}/batch/{batch_id}.json
Shopify Retrieves A Discount Code Creation Job
deprecated_202004_get_price_rules_param_price_rule_id_batch_param_batch_id 2 params → 200
GET
/admin/api/2020-04/price_rules/{price_rule_id}/batch/{batch_id}/discount_codes.json
Shopify Retrieves A List Of Discount Codes For A Discount Code Creation Job
deprecated_202004_get_price_rules_param_price_rule_id_batch_param_batch_id_discount_codes 2 params → 200
POST
/admin/api/2020-07/price_rules/{price_rule_id}/discount_codes.json
Shopify Creates A Discount Code
deprecated_202007_create_price_rules_param_price_rule_id_discount_codes 1 param body → 200
GET
/admin/api/2020-07/price_rules/{price_rule_id}/discount_codes.json
Shopify Retrieve A List Of Discount Codes
deprecated_202007_get_price_rules_param_price_rule_id_discount_codes 1 param → 200
PUT
/admin/api/2020-07/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Updates An Existing Discount Code
deprecated_202007_update_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params body → 200
GET
/admin/api/2020-07/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Retrieves A Single Discount Code
deprecated_202007_get_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
DELETE
/admin/api/2020-07/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Deletes A Discount Code
deprecated_202007_delete_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
GET
/admin/api/2020-07/discount_codes/lookup.json
Shopify Retrieves The Location Of A Discount Code
deprecated_202007_get_discount_codes_lookup 1 param → 200
POST
/admin/api/2020-07/price_rules/{price_rule_id}/batch.json
Shopify Creates A Discount Code Creation Job
deprecated_202007_create_price_rules_param_price_rule_id_batch 1 param body → 200
GET
/admin/api/2020-07/price_rules/{price_rule_id}/batch/{batch_id}.json
Shopify Retrieves A Discount Code Creation Job
deprecated_202007_get_price_rules_param_price_rule_id_batch_param_batch_id 2 params → 200
GET
/admin/api/2020-07/price_rules/{price_rule_id}/batch/{batch_id}/discount_codes.json
Shopify Retrieves A List Of Discount Codes For A Discount Code Creation Job
deprecated_202007_get_price_rules_param_price_rule_id_batch_param_batch_id_discount_codes 2 params → 200
POST
/admin/api/2020-10/price_rules/{price_rule_id}/discount_codes.json
Shopify Creates A Discount Code
create_price_rules_param_price_rule_id_discount_codes 1 param body → 200
GET
/admin/api/2020-10/price_rules/{price_rule_id}/discount_codes.json
Shopify Retrieve A List Of Discount Codes
get_price_rules_param_price_rule_id_discount_codes 1 param → 200
PUT
/admin/api/2020-10/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Updates An Existing Discount Code
update_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params body → 200
GET
/admin/api/2020-10/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Retrieves A Single Discount Code
get_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
DELETE
/admin/api/2020-10/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Deletes A Discount Code
delete_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
GET
/admin/api/2020-10/discount_codes/lookup.json
Shopify Retrieves The Location Of A Discount Code
get_discount_codes_lookup 1 param → 200
POST
/admin/api/2020-10/price_rules/{price_rule_id}/batch.json
Shopify Creates A Discount Code Creation Job
create_price_rules_param_price_rule_id_batch 1 param body → 200
GET
/admin/api/2020-10/price_rules/{price_rule_id}/batch/{batch_id}.json
Shopify Retrieves A Discount Code Creation Job
get_price_rules_param_price_rule_id_batch_param_batch_id 2 params → 200
GET
/admin/api/2020-10/price_rules/{price_rule_id}/batch/{batch_id}/discount_codes.json
Shopify Retrieves A List Of Discount Codes For A Discount Code Creation Job
get_price_rules_param_price_rule_id_batch_param_batch_id_discount_codes 2 params → 200
POST
/admin/api/2021-01/price_rules/{price_rule_id}/discount_codes.json
Shopify Creates A Discount Code
deprecated_202101_create_price_rules_param_price_rule_id_discount_codes 1 param body → 200
GET
/admin/api/2021-01/price_rules/{price_rule_id}/discount_codes.json
Shopify Retrieve A List Of Discount Codes
deprecated_202101_get_price_rules_param_price_rule_id_discount_codes 1 param → 200
PUT
/admin/api/2021-01/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Updates An Existing Discount Code
deprecated_202101_update_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params body → 200
GET
/admin/api/2021-01/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Retrieves A Single Discount Code
deprecated_202101_get_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
DELETE
/admin/api/2021-01/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Deletes A Discount Code
deprecated_202101_delete_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
GET
/admin/api/2021-01/discount_codes/lookup.json
Shopify Retrieves The Location Of A Discount Code
deprecated_202101_get_discount_codes_lookup 1 param → 200
POST
/admin/api/2021-01/price_rules/{price_rule_id}/batch.json
Shopify Creates A Discount Code Creation Job
deprecated_202101_create_price_rules_param_price_rule_id_batch 1 param body → 200
GET
/admin/api/2021-01/price_rules/{price_rule_id}/batch/{batch_id}.json
Shopify Retrieves A Discount Code Creation Job
deprecated_202101_get_price_rules_param_price_rule_id_batch_param_batch_id 2 params → 200
GET
/admin/api/2021-01/price_rules/{price_rule_id}/batch/{batch_id}/discount_codes.json
Shopify Retrieves A List Of Discount Codes For A Discount Code Creation Job
deprecated_202101_get_price_rules_param_price_rule_id_batch_param_batch_id_discount_codes 2 params → 200
POST
/admin/api/unstable/price_rules/{price_rule_id}/discount_codes.json
Shopify Creates A Discount Code
deprecated_unstable_create_price_rules_param_price_rule_id_discount_codes 1 param body → 200
GET
/admin/api/unstable/price_rules/{price_rule_id}/discount_codes.json
Shopify Retrieve A List Of Discount Codes
deprecated_unstable_get_price_rules_param_price_rule_id_discount_codes 1 param → 200
PUT
/admin/api/unstable/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Updates An Existing Discount Code
deprecated_unstable_update_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params body → 200
GET
/admin/api/unstable/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Retrieves A Single Discount Code
deprecated_unstable_get_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
DELETE
/admin/api/unstable/price_rules/{price_rule_id}/discount_codes/{discount_code_id}.json
Shopify Deletes A Discount Code
deprecated_unstable_delete_price_rules_param_price_rule_id_discount_codes_param_discount_code_id 2 params → 200
GET
/admin/api/unstable/discount_codes/lookup.json
Shopify Retrieves The Location Of A Discount Code
deprecated_unstable_get_discount_codes_lookup 1 param → 200
POST
/admin/api/unstable/price_rules/{price_rule_id}/batch.json
Shopify Creates A Discount Code Creation Job
deprecated_unstable_create_price_rules_param_price_rule_id_batch 1 param body → 200
GET
/admin/api/unstable/price_rules/{price_rule_id}/batch/{batch_id}.json
Shopify Retrieves A Discount Code Creation Job
deprecated_unstable_get_price_rules_param_price_rule_id_batch_param_batch_id 2 params → 200
GET
/admin/api/unstable/price_rules/{price_rule_id}/batch/{batch_id}/discount_codes.json
Shopify Retrieves A List Of Discount Codes For A Discount Code Creation Job
deprecated_unstable_get_price_rules_param_price_rule_id_batch_param_batch_id_discount_codes 2 params → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

shopify-discount-api-openapi.yml Raw ↑

Other APIs Shopify publishes across the network.

Shopify GraphQL Admin API
Shopify Storefront API
Shopify Customer Account API
Shopify Partner API
Shopify Payments Apps API
Shopify Liquid API
Shopify Functions API
Shopify Discount Function API
Shopify Webhooks API
Shopify App Bridge
Shopify App Home API
Shopify Checkout UI Extensions API
Where this information came from

This is an independent, third-party profile of Shopify Discount API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.