Salla Docs
Merchant API
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
Partner APIs
  • App API
  • Shipments & Fulfillment APIs
  • Salla AWB
  • Recurring Payments API
  • App Functions
  • Billing System Salla partners
Storefront
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Ecommerce Events
  • Change Log
Salla CLI
Merchant API
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
Partner APIs
  • App API
  • Shipments & Fulfillment APIs
  • Salla AWB
  • Recurring Payments API
  • App Functions
  • Billing System Salla partners
Storefront
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Ecommerce Events
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Special Offers
  • 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 Options
      • List Order Options
      • Order Option Details
      • Create Order Option
      • Update Order Option
      • Delete Order Options
    • Order Invoice
      • Create Invoice
      • List Invoices
      • Invoice Details
      • Send Order Invoice
      • Create Order Invoice
    • Order Reservations
      • List Order Reservations
    • Districts
      • List Districts
    • 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
    • Digitals Product
      • Attach Digital Code
      • Attach Digital File
      • Delete Digital File
    • Store Scopes
      • List Store Scopes
      • Store Scope Details
    • Abandoned Carts
      • List Abandoned Carts
      • Abandoned Cart Details
    • Customers
      • Create Customer
      • List Customers
      • Customer Details
      • Update Customer
      • Delete Customer
      • Ban Customer
      • Un-Ban customer
      • Import Customers
    • Customer Groups
      • Create Customer Group
      • List Customer Groups
      • Add Customers To Group Customer
      • Update Default Customer Group
      • Update Customer Group
      • Delete Customer Group
    • Customer Wallet
      • Deposit to Wallet
      • Withdraw from Wallet
    • Categories
      • Create Category
      • List Categories
      • Category Details
      • Update Category
      • Delete Category
      • Category Children
      • Categories Search
      • List Category Products
    • Shipments
      • Create Shipment
      • List Shipments
      • Update Shipment Details
      • Shipment Details
      • Cancel Shipment
      • Return Shipment
      • Shipment Tracking
    • 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 Routes
      • Routes List
      • Route Details
      • Create Route
      • Update Route
      • Default Route
      • Delete Route
    • Countries
      • List Countries
      • Country Details
    • Cities
      • List Cities
    • 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
      • List Coupons
      • Coupon Details
      • Update Coupon
      • Delete Coupon
      • List Coupon Codes
    • Affiliates
      • List Affiliates
      • Affiliate Details
      • List Affiliate Links
      • 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
        POST
      • List Special Offers
        GET
      • Special Offer Details
        GET
      • Update Special Offer
        PUT
      • Delete Special Offer
        DELETE
      • Change Special Offer Status
        PUT
    • Transactions
      • List Transactions
      • Transaction Details
      • Print Transaction Invoice
      • Update Transaction
    • Payments
      • Available Payment Methods
      • List Banks
      • Payment Bank 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
      • Branch Allocation Details
      • Create Branches Allocations
      • Update Branches Allocations
      • Delete Branches Allocations
      • Allocation Branch Settings
      • List Branches Allocations
    • Branch Delivery Zones
      • List Branch Delivery Zones
      • Branch Delivery Zone Details
      • Create Branch Delivery Zone
      • Update Branch Delivery Zone
      • Delete Branch Delivery Zone
    • Currencies
      • Activate Currencies
      • List Currencies
      • List Available Currencies
    • SEO
      • List SEO Settings
      • Update SEO Settings
    • 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
      • Register Webhook
      • Update Webhook
      • List Active Webhooks
      • List Events
      • Deactivate Webhook
    • Custom URLs
      • Import Custom URLs
    • Loyalty Points
      • Customer Loyalty Points
      • Update Customer Loyalty Points
    • Reviews
      • List Reviews
      • Review Details
      • Update Review
    • Feedbacks
      • List Feedbacks
      • Feedback Details
      • Update Feedback
      • Store Feedback
      • Feedback Reply
      • Update Feedback Reply
  • Webhooks - Store Events
    • Shippings
    • Brand
    • Product
    • Category
    • Store
    • Special Offer
    • Cart
    • Shipments
    • Miscellaneous
    • Invoice
    • Order
    • Customer
    • Communication Webhooks
Merchant API
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
Partner APIs
  • App API
  • Shipments & Fulfillment APIs
  • Salla AWB
  • Recurring Payments API
  • App Functions
  • Billing System Salla partners
Storefront
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Ecommerce Events
  • Change Log
Salla CLI
Merchant API
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
Partner APIs
  • App API
  • Shipments & Fulfillment APIs
  • Salla AWB
  • Recurring Payments API
  • App Functions
  • Billing System Salla partners
Storefront
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Ecommerce Events
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Special Offers

List Special Offers

Production
https://api.salla.dev/admin/v2
Production
https://api.salla.dev/admin/v2
GET
https://api.salla.dev/admin/v2
/specialoffers
Last modified:2026-01-25 14:52:08
This endpoint allows you to list all special offers related to the store.
Scopes
specialoffers.read- Special Offers 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 Code 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/specialoffers?per_page&page' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Success
application/json
Body

Example
{
    "status": 200,
    "success": true,
    "data": [
        {
            "id": 336373960,
            "name": "New Year Offer",
            "message": "Buy One Get One Free",
            "expiry_date": "2026-01-30 00:00:00",
            "start_date": "2026-01-01 00:00:00",
            "offer_type": "buy_x_get_y",
            "status": "inactive",
            "show_price_after_discount": false,
            "show_discounts_table_message": false,
            "countries": [
                566146469,
                1473353380
            ],
            "customer_groups": [
                1354073706
            ],
            "applied_to": "product",
            "select_by": "mobile",
            "options": [],
            "based_on": null,
            "buy": {
                "type": "product",
                "quantity": 1,
                "products": []
            },
            "get": {
                "type": "product",
                "discount_type": "percentage",
                "quantity": "1",
                "products": [
                    {
                        "id": 1298176905,
                        "type": "product",
                        "promotion": {
                            "title": null,
                            "sub_title": null
                        },
                        "quantity": 10,
                        "status": "sale",
                        "is_available": true,
                        "sku": "P-7376",
                        "name": "Product 01",
                        "price": {
                            "amount": 123,
                            "currency": "SAR"
                        },
                        "sale_price": {
                            "amount": 0,
                            "currency": "SAR"
                        },
                        "currency": "SAR",
                        "url": "https://mozdanastore.com/ar/testaa/p1298176905",
                        "thumbnail": null,
                        "has_special_price": false,
                        "regular_price": {
                            "amount": 123,
                            "currency": "SAR"
                        },
                        "calories": null,
                        "mpn": null,
                        "gtin": null,
                        "description": "",
                        "has_preorder_campaign": false,
                        "preorder": null,
                        "favorite": null,
                        "features": {
                            "availability_notify": null,
                            "show_rating": true
                        },
                        "activePreorderCampaign": null
                    }
                ],
                "discount_amount": "5.00"
            },
            "tiers": [],
            "apply_type": null,
            "with_current_cart": false,
            "special_price": null,
            "applied_with_coupon": false,
            "scopes": [
                289292369,
                1473353380
            ],
            "exclude_sale_items": false,
            "excluded_buy_products_ids": [],
            "excluded_buy_categories_ids": []
        },
        {
            "id": 1601705172,
            "name": "Basket Offer",
            "message": "",
            "expiry_date": "2026-02-28 00:00:00",
            "start_date": "2026-01-29 00:00:00",
            "offer_type": "cart_offer",
            "status": "inactive",
            "show_price_after_discount": null,
            "show_discounts_table_message": false,
            "countries": [],
            "customer_groups": [],
            "applied_to": null,
            "select_by": "",
            "options": [
                {
                    "id": 0,
                    "discount_apply_type": "percentage",
                    "condition_threshold": 10,
                    "max_customer_discount": 50,
                    "discount_amount": 20
                }
            ],
            "based_on": "products_count",
            "buy": {
                "min_amount": 0,
                "min_items": 0
            },
            "get": {
                "discount_amount": null
            },
            "tiers": [],
            "apply_type": null,
            "with_current_cart": false,
            "special_price": null,
            "applied_with_coupon": false,
            "scopes": [],
            "exclude_sale_items": false,
            "excluded_buy_products_ids": [],
            "excluded_buy_categories_ids": []
        },
        {
            "id": 2065846998,
            "name": "Special Price Offer",
            "message": "This message describes the offer",
            "expiry_date": "2026-04-26 00:00:00",
            "start_date": "2026-01-26 00:00:00",
            "offer_type": "special_price",
            "status": "inactive",
            "show_price_after_discount": false,
            "show_discounts_table_message": false,
            "countries": [],
            "customer_groups": [
                1354073706
            ],
            "applied_to": "product",
            "select_by": "",
            "options": [],
            "based_on": null,
            "buy": {
                "min_amount": 0,
                "min_items": 0,
                "products": []
            },
            "get": {
                "discount_amount": "0.00"
            },
            "tiers": [],
            "apply_type": null,
            "with_current_cart": false,
            "special_price": {
                "quantity": 3,
                "price": 90
            },
            "applied_with_coupon": false,
            "scopes": [],
            "exclude_sale_items": false,
            "excluded_buy_products_ids": [],
            "excluded_buy_categories_ids": []
        }
    ],
    "pagination": {
        "count": 3,
        "total": 231,
        "perPage": 3,
        "currentPage": 76,
        "totalPages": 77,
        "links": {
            "previous": "http://api.salla.dev/admin/v2/specialoffers?per_page=3&page=75",
            "next": "http://api.salla.dev/admin/v2/specialoffers?per_page=3&page=77"
        }
    }
}
🟠401Unauthorized
Modified at 2026-01-25 14:52:08
Previous
Create Special Offer
Next
Special Offer Details