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. 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 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
      • List Coupons
      • Coupon Details
      • Update Coupon
      • Delete Coupon
      • List Coupon Codes
    • 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
        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
    • 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. 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:2025-01-26 10:43:04
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 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'

Responses

🟢200Success
application/json
Body

Example
{
    "status": 200,
    "success": true,
    "data": [
        {
            "id": 613755483,
            "name": "new free",
            "message": "اشتري one piece واحصل على specialoffer::special_offers.messages.get-discount- من المنتجات التالية",
            "expiry_date": null,
            "start_date": null,
            "offer_type": "",
            "status": "active",
            "show_price_after_discount": null,
            "show_discounts_table_message": false,
            "applied_to": null,
            "buy": {
                "min_amount": 0,
                "min_items": 0
            },
            "get": {
                "discount_amount": null
            }
        },
        {
            "id": 400525076,
            "name": "new offer",
            "message": "First Offer Congratulations {offer_get_qty} {offer_percent} Try our new offer {offer_buy_qty} and apply the following code: AZ https://shalfa.net/m/?",
            "expiry_date": "2024-09-01 01:00:00",
            "start_date": "2024-08-25 16:00:00",
            "offer_type": "fixed_amount",
            "status": "active",
            "show_price_after_discount": false,
            "show_discounts_table_message": false,
            "applied_to": "category",
            "buy": {
                "min_amount": 0,
                "min_items": 1,
                "categories": [
                    {
                        "id": 283675303,
                        "name": "ماركة بيوديرما",
                        "avatar": "",
                        "created_at": "2022-03-07T11:57:13.000000Z",
                        "updated_at": "2022-04-19T11:25:45.000000Z",
                        "deleted_at": null,
                        "store_id": 4934,
                        "parent_id": 2062595,
                        "products_counts": 0,
                        "show_in_menu": 1,
                        "sort_order": 1,
                        "status": "active",
                        "has_hidden_products": 0,
                        "show_in_app": 1,
                        "extra_attributes": [],
                        "custom_url": null,
                        "mahly_category_id": null,
                        "images": null
                    }
                ]
            },
            "get": {
                "discount_amount": "1.00"
            }
        },
        {
            "id": 1259945644,
            "name": "test",
            "message": "اشتري  -4 pieces واحصل على خصم 1900 SAR من التصنيفات التالية",
            "expiry_date": "2025-05-08 00:00:00",
            "start_date": null,
            "offer_type": "fixed_amount",
            "status": "inactive",
            "show_price_after_discount": null,
            "show_discounts_table_message": false,
            "applied_to": "category",
            "buy": {
                "min_amount": 0,
                "min_items": -4,
                "categories": [
                    {
                        "id": 1794053675,
                        "name": "Dress",
                        "avatar": "",
                        "created_at": "2021-09-19T08:17:57.000000Z",
                        "updated_at": "2023-12-30T11:41:48.000000Z",
                        "deleted_at": null,
                        "store_id": 4934,
                        "parent_id": 677747738,
                        "products_counts": 15,
                        "show_in_menu": 0,
                        "sort_order": 5,
                        "status": "active",
                        "has_hidden_products": 0,
                        "show_in_app": 1,
                        "extra_attributes": {
                            "metadata": {
                                "title": "حلو",
                                "description": "حلو و جميل ههاي ههاي"
                            }
                        },
                        "custom_url": "order",
                        "mahly_category_id": null,
                        "images": "https://cdn.salla.sa/jKxK/t5kk3PVtwdw3xdYP7XHkaoWQ4punxq3mL1lJ3GvS.jpg"
                    }
                ]
            },
            "get": {
                "discount_amount": "1900.00"
            }
        },
        {
            "id": 619077037,
            "name": "test 2",
            "message": "اشتري one piece واحصل على خصم 2 SAR من التصنيفات التالية",
            "expiry_date": "2022-08-24 17:45:00",
            "start_date": null,
            "offer_type": "fixed_amount",
            "status": "inactive",
            "show_price_after_discount": null,
            "show_discounts_table_message": false,
            "applied_to": "category",
            "buy": {
                "min_amount": 0,
                "min_items": 1,
                "categories": [
                    {
                        "id": 759876799,
                        "name": "Others",
                        "avatar": "",
                        "created_at": "2021-07-
🟠401Unauthorized
Modified at 2025-01-26 10:43:04
Previous
Create Special Offer
Next
Special Offer Details