Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Coupons
  • Welcome 👋
  • Get Started
  • Create Your First App
  • Authorization
  • Webhooks
  • Conditional Webhooks
  • Security Considerations
  • Multi-Language Support
  • Responses
  • Pagination
  • Rate Limiting
  • Versioning
  • Change Log
  • Support
  • APIs
    • Orders
      • Create Order
      • List Orders
      • Order Details
      • Create Drafted Order
      • Update Order
      • Duplicate Order
      • Order Actions
      • Relocate Order Stock
    • Order Items
      • List Order Items
      • Create Order Item
      • Update Order Item
      • Delete Order Item
    • Order Status
      • Update Order Status
      • Create Custom Order Status
      • List Order Statuses
      • Order Status Details
      • Update Custom Order Status
      • Update Bulk Orders Statuses
      • Sort Orders Statuses
    • Order Histories
      • List Order Histories
      • Create Order History
    • Order Tags
      • Create Order Tag
      • List Order Tags
      • Delete Order Tag
    • Order Invoice
      • Create Invoice
      • List Invoices
      • Invoice Details
      • Send Order Invoice
      • Create Order Invoice
    • Order Reservations
      • List Order Reservations
    • Settings
      • Settings List
      • Update Setting Slug
      • Setting Details
    • Exports
      • Export Orders
      • Exports Logs
      • List Export Templates
      • Create Export Template
      • Update Export Template
      • Delete Export Template
      • List Export Columns
      • Export Customers
      • Export Custom URLs
      • Export Products
    • Products
      • Create Product
      • List Products
      • Product Details
      • Update Product
      • Delete Product
      • Change Product Status
      • Product Details By SKU
      • Update Product By SKU
      • Delete Product By SKU
      • Update Product Price By SKU
      • Update Bulk Product Prices
      • Import Products
      • Bulk Product Actions
    • Product Options
      • Create Product Option
      • Product Option Details
      • Update Product Option
      • Delete Product Option
    • Product Quantity
      • Update Bulk Quantities
      • List Product Quantities
      • List Quantity Change Reasons
      • List Quantity Audit
    • Product Variants
      • List Product Variants
      • Product Variant Details
      • Update Product Variant
      • Update Product Variant Quantity
    • Product Tags
      • Create Product Tag
      • List Product Tags
    • Product Images
      • Attach Image by SKU
      • Attach Video by SKU
      • Attach Youtube Video
      • Attach Image
      • Update Image
      • Delete Image
    • Product Option Values
      • Create Product Option Value
      • Product Option Value Details
      • Update Product Option Value
      • Delete Product Option Value
    • Abandoned Carts
      • List Abandoned Carts
      • Abandoned Cart Details
    • Customer Groups
      • Create Customer Group
      • List Customer Groups
      • Add Customers To Group Customer
      • Update Default Customer Group
      • Update Customer Group
      • Delete Customer Group
    • Customers
      • Create Customer
      • List Customers
      • Customer Details
      • Update Customer
      • Delete Customer
      • Ban Customer
      • Un-Ban customer
      • Import Customers
    • Digitals Product
      • Attach Digital Code
      • Attach Digital File
      • Delete Digital File
    • Categories
      • Create Category
      • List Categories
      • Category Details
      • Update Category
      • Delete Category
      • Category Children
      • Categories Search
      • List Category Products
    • Shipments
      • Create Shipment
      • List Shipments
      • Shipment Details
      • Shipment Tracking
      • Update Shipment Details
      • Cancel Shipment
      • Return Shipment
    • Shipping Companies
      • Create Shipping Company
      • Shipping Company Options
      • List Shipping Companies
      • Shipping Company Details
      • Update Shipping Company
      • Delete Shipping Company
      • List Estimate Rates
    • Shipping Zones
      • Create Shipping Zone
      • List Shipping Zones
      • Shipping Zone Details
      • Update Shipping Zone
      • Delete Shipping Zone
    • Shipping Rules
      • List Shipping Rules
      • Shipping Rule Details
      • Delete Shipping Rule
    • Shipping Routes
      • Routes List
      • Route Details
      • Create Route
      • Update Route
      • Default Route
      • Delete Route
    • Countries
      • List Countries
      • Country Details
    • Product Option Templates
      • List Option Templates
      • Option Template Details
      • Delete Option Template
      • Update Option Template
      • Create Option Template
    • Taxes
      • Create Tax
      • List Taxes
      • Tax Details
      • Update Tax
      • Delete Tax
    • Coupons
      • Create Coupon
        POST
      • List Coupons
        GET
      • Coupon Details
        GET
      • Update Coupon
        PUT
      • Delete Coupon
        DELETE
      • List Coupon Codes
        GET
    • Affiliates
      • List Affiliates
      • Affiliate Details
      • Create Affiliate
      • Update Affiliate
      • Delete Affiliate
    • Order Assignment
      • List Auto Assignment Rules
      • Order Assigned Employees Details
      • Update Auto Assignment Rule
      • Create Auto Assignment Rules
    • Special Offers
      • Create Special Offer
      • List Special Offers
      • Special Offer Details
      • Update Special Offer
      • Delete Special Offer
      • Change Special Offer Status
    • Transactions
      • List Transactions
      • Transaction Details
      • Print Transaction Invoice
      • Update Transaction
    • Payments
      • Available Payment Methods
      • List Banks
      • Payment Bank Details
    • Settlements
      • List Instant Settlements
      • Create Instant Settlement
      • Update Instant Settlement
      • Instant Settlement Details
    • Merchant
      • User Information Details
      • Store Information
    • Brands
      • Create Brand
      • List Brands
      • Brand Details
      • Update Brand
      • Delete Brand
    • Branches
      • Create Branch
      • List Branches
      • Branch Details
      • Update Branch
      • Delete Branch
    • Branches Allocations
      • List Branches Allocations
      • Branch Allocation Details
      • Create Branches Allocations
      • Update Branches Allocations
      • Delete Branches Allocations
    • Currencies
      • Activate Currencies
      • List Currencies
      • List Available Currencies
    • SEO
      • List SEO Settings
      • Update SEO Settings
    • Cities
      • List Cities
    • DNS Records
      • List DNS Records
      • Create DNS Record
      • Delete DNS Record
    • Languages
      • Add Language
      • List Languages
      • Update Language
    • Employees
      • List Employees
    • Advertisements
      • Create Advertisement
      • List Advertisements
      • Advertisement Details
      • Update Advertisement
      • Delete Advertisement
    • Webhooks
      • List Active Webhooks
      • List Events
      • Register Webhook
      • Deactivate Webhook
      • Update Webhook
    • Custom URLs
      • Import Custom URLs
    • Loyalty Points
      • Customer Loyalty Points
      • Update Customer Loyalty Points
    • Reviews
      • List Reviews
      • Review Details
      • Update Review
  • Webhooks - Store Events
    • Shippings
    • Brand
    • Product
    • Customer
    • Category
    • Store
    • Special Offer
    • Cart
    • Shipments
    • Miscellaneous
    • Invoice
    • Order
  1. Coupons

List Coupons

Production
https://api.salla.dev/admin/v2
Production
https://api.salla.dev/admin/v2
GET
https://api.salla.dev/admin/v2
/coupons
Last modified:2025-06-15 13:31:16
This endpoint allows you to return a list of coupons.
Scopes
marketing.read- Marketing Read Only

Request

Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Query Params

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.salla.dev/admin/v2/coupons?keyword'

Responses

🟢200Success
application/json
Body

Example
{
    "status": 200,
    "success": true,
    "data": [
        {
            "id": 6930446,
            "code": "DEAL",
            "type": "fixed",
            "status": "active",
            "is_apply_with_offer": true,
            "amount": {
                "amount": 30,
                "currency": "SAR"
            },
            "minimum_amount": 90,
            "maximum_amount": {
                "amount": 0,
                "currency": "SAR"
            },
            "show_maximum_amount": false,
            "expiry_date": "2024-03-17 00:00:00",
            "start_date": "2025-03-17 00:00:00",
            "free_shipping": true,
            "usage_limit": 90,
            "usage_limit_per_user": 80,
            "include_product_ids": [],
            "exclude_product_ids": [],
            "is_sale_products_exclude": true,
            "include_category_ids": [],
            "exclude_category_ids": [],
            "include_customer_group_ids": [],
            "exclude_customer_group_ids": [],
            "exclude_brands_ids": [],
            "exclude_shipping_ids": [],
            "include_payment_methods": [],
            "applied_in": "all",
            "is_group": true,
            "group_name": "Deals",
            "group_coupons_count": 3,
            "group_coupon_suffix": "DEAL",
            "group_coupons": [
                {
                    "code": "DEAL5Wsl"
                },
                {
                    "code": "DEALgaNN"
                },
                {
                    "code": "DEALFRa7"
                }
            ],
            "beneficiary_domain": "domain.test",
            "statistics": {
                "num_of_usage": 0,
                "num_of_customers": 0,
                "coupon_sales": {
                    "amount": 0,
                    "currency": "SAR"
                }
            },
            "created_at": {
                "date": "2022-04-06 12:55:06.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "updated_at": {
                "date": "2022-04-06 12:55:06.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "marketing_active": false,
            "marketing_name": "Name of Marketing",
            "marketing_type": "Percentage",
            "marketing_amount": 500,
            "marketing_hide_total_sales": false,
            "marketing_show_maximum_amount": false,
            "marketing_maximum_amount": 10000,
            "marketing_info": "Additional Notes",
            "marketing_visits_count": 80,
            "marketing_url": "https://salla.sa/teststore?utm_source=ref&utm_campaign=QAZCVS",
            "marketing_statistics_url": "https://mtjr.coupons/VvVMP"
        },
        {
            "id": 1622617640,
            "code": "QAZCVS",
            "type": "fixed",
            "status": "active",
            "is_apply_with_offer": true,
            "amount": {
                "amount": 30,
                "currency": "SAR"
            },
            "minimum_amount": 9000,
            "maximum_amount": {
                "amount": 0,
                "currency": "SAR"
            },
            "show_maximum_amount": false,
            "expiry_date": "2025-02-17 00:00:00",
            "start_date": "2026-03-17 00:00:00",
            "free_shipping": true,
            "usage_limit": 600,
            "usage_limit_per_user": 8,
            "include_product_ids": [],
            "exclude_product_ids": [],
            "is_sale_products_exclude": true,
            "include_category_ids": [],
            "exclude_category_ids": [],
            "include_customer_group_ids": [],
            "exclude_customer_group_ids": [],
            "exclude_brands_ids": [],
            "exclude_shipping_ids": [],
            "include_payment_methods": [],
            "applied_in": "all",
            "is_group": false,
            "group_name": "Grouping1",
            "group_coupons_count": 90,
            "group_coupon_suffix": "xyz",
            "group_coupons": [],
            "beneficiary_domain": "domain.test",
            "statistics": {
                "num_of_usage": 0,
                "num_of_customers": 0,
                "coupon_sales": {
                    "amount": 0,
                    "currency": "SAR"
                }
            },
            "created_at": {
                "date": "2022-04-06 12:45:13.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "updated_at": {
                "date": "2022-04-06 12:45:13.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "marketing_active": true,
            "marketing_name": "Nabil",
            "marketing_type": "percentage",
            "marketing_amount": {
                "amount": 10,
                "currency": "SAR"
            },
            "marketing_hide_total_sales": false,
            "marketing_show_maximum_amount": false,
            "marketing_info": "",
            "marketing_visits_count": 0,
            "marketing_url": "https://salla.sa/dev-wofftr4xsra5xtlv?utm_source=ref&utm_campaign=QAZCVS",
            "marketing_statistics_url": "https://mtjr.coupons/w172T"
        },
        {
            "id": 242399780,
            "code": "azvfpsv",
            "type": "fixed",
            "status": "active",
            "is_apply_with_offer": true,
            "amount": {
                "amount": 30,
                "currency": "SAR"
            },
            "minimum_amount": {
                "amount": 100,
                "currency": "SAR"
            },
            "maximum_amount": {
                "amount": 50,
                "currency": "SAR"
            },
            "show_maximum_amount": false,
            "expiry_date": "2023-03-17 00:00:00",
            "start_date": "2022-04-24 06:00:00",
            "free_shipping": true,
            "usage_limit": 10,
            "usage_limit_per_user": 1,
            "include_product_ids": [
                1261174103
            ],
            "exclude_product_ids": [
                277818017
            ],
            "is_sale_products_exclude": true,
            "include_category_ids": [
                256950451,
                2064430530
            ],
            "exclude_category_ids": [
                307036893
            ],
            "include_customer_group_ids": [
                667738032
            ],
            "exclude_customer_group_ids": [],
            "exclude_brands_ids": [
                1097509908
            ],
            "exclude_shipping_ids": [
                1935030040
            ],
            "include_payment_methods": [
                "all"
            ],
            "applied_in": "all",
            "is_group": false,
            "group_name": "Grouping1",
            "group_coupons_count": 90,
            "group_coupon_suffix": "bvg",
            "group_coupons": [],
            "beneficiary_domain": "salla.sa",
            "statistics": {
                "num_of_usage": 0,
                "num_of_customers": 0,
                "coupon_sales": {
                    "amount": 0,
                    "currency": "SAR"
                }
            },
            "created_at": {
                "date": "2022-04-06 12:38:06.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "updated_at": {
                "date": "2022-04-06 12:59:14.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "marketing_active": true,
            "marketing_name": "User Name",
            "marketing_type": "percentage",
            "marketing_amount": {
                "amount": 5,
                "currency": "SAR"
            },
            "marketing_hide_total_sales": false,
            "marketing_show_maximum_amount": true,
            "marketing_maximum_amount": 4000,
            "marketing_info": "Marketing coupon for User Name",
            "marketing_visits_count": 0,
            "marketing_url": "https://salla.sa/dev-wofftr4xsra5xtlv?utm_source=ref&utm_campaign=azvfpsv",
            "marketing_statistics_url": "https://mtjr.coupons/eqOuz"
        }
    ],
    "pagination": {
        "count": 3,
        "total": 3,
        "perPage": 15,
        "currentPage": 1,
        "totalPages": 1,
        "links": []
    }
}
🟠401Unauthorized
Modified at 2025-06-15 13:31:16
Previous
Create Coupon
Next
Coupon Details