REST API

Regios Discounts provides a REST API for managing discounts and redeem codes. This allows you to integrate our app into more complex, ad-hoc workflows.

Use Cases

• Importing discounts in bulk from other sources
• Automatically creating new redeem codes for a discount in response to triggers (e.g. unique codes for email subscribers)

How to Create an API Key

1. Click "Settings" in the app navigation.
2. Scroll down to "REST API," and click "Manage API keys."
3. Click "Create API key."
4. You will be shown the public and secret key for the new key. Copy and store the secret key; you will not be able to access it again.

How to Use the API

The API is hosted at https://automatic-discounts.regiostech.com/api/v1 . You must use HTTP Basic Auth - provide your public key as the username and your secret key as the password.

Accessing API Docs

We provide interactive Swagger API docs at https://automatic-discounts.regiostech.com/api/v1/docs. These docs allow you:

• Read detailed information about every endpoint
• View example usage
• Interactively test out endpoints for faster prototyping

FAQ

Is the REST API included in all plans?

Yes. The REST API is available on all plans. You can also use the REST API while on a free trial of our app.

Is there an API endpoint to check whether a redeem code has been used or redeemed?

Yes. You can look up a single redeem code and see how many times it has been used with this endpoint:

GET /discounts/code/{discountId}/redeem-codes/{code}

Replace {discountId} with the ID of the code discount the code belongs to, and {code} with the exact redeem code (the lookup is case-sensitive). The full URL looks like this:

https://automatic-discounts.regiostech.com/api/v1/discounts/code/{discountId}/redeem-codes/{code}

The response returns the code along with its usage count in the asyncUsageCount field:

{
  "id": "gid://shopify/DiscountRedeemCode/123456789",
  "code": "SUMMER10",
  "asyncUsageCount": 42
}

In this example, the code "SUMMER10" has been used 42 times; a value of 0 means it has not been used yet. If the code is not attached to that discount, the endpoint returns a 404 response. You can also find this endpoint, with its full schema and an interactive example, in the Swagger API docs.

Your Feedback Matters

Your review helps keep this small business running. Please leave one on the Shopify App Store.

Updated on: 22/06/2026