Salla Docs
Merchant
Merchant
  • Merchant API
  • Salla OAuth 2.0
  • Merchant Dashboard
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
Merchant
  • Merchant API
  • Salla OAuth 2.0
  • Merchant Dashboard
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. Orders
  • 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
        POST
      • List Orders
        GET
      • Order Details
        GET
      • Create Drafted Order
        POST
      • Update Order
        PUT
      • Duplicate Order
        POST
      • Order Actions
        POST
      • Relocate Order Stock
        POST
    • 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
      • 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
    • 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
Merchant
  • Merchant API
  • Salla OAuth 2.0
  • Merchant Dashboard
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
Merchant
  • Merchant API
  • Salla OAuth 2.0
  • Merchant Dashboard
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. Orders

Order Details

Production
https://api.salla.dev/admin/v2
Production
https://api.salla.dev/admin/v2
GET
https://api.salla.dev/admin/v2
/orders/{order_id}
Last modified:2026-01-26 10:50:33
This endpoint allows you to return the details for a specific order by passing the order_id as a path parameter.
Note
• You can able to send the reference_id as a query parameter to get order details. Check the List Orders Endpoint for more.
• If you send the query parameter format and set it equal to light, you will receive the order details without Shipments, Items, Pickup Branch, and Customer Groups objects.
• For old apps (expanded query parameter), the shipping_details_id inside the shipping object response matches the id returned by the shipping estimated rate endpoint.
Scopes
orders.read - Orders Read Only

Request

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

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/orders/3155923424?format=light' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Default Response
application/json
Body

Examples
{
    "status": 200,
    "success": true,
    "data": {
        "id": 418149270,
        "checkout_id": 1464750392,
        "reference_id": 3879219,
        "features": {
            "shippable": true,
            "digitalable": false,
            "multiple_shipments_supported": false,
            "order_type_price_quote": false,
            "has_suspicious_alert": false
        },
        "actions": {
            "cancellable": false,
            "reorderable": true,
            "payable": true
        },
        "urls": {
            "customer": "http://store.test/ar/hemo.store/order/wRK4mBzAZN081YbbX3dal23kYrbxqP7j",
            "admin": "/orders/order/wRK4mBzAZN081YbbX3dal23kYrbxqP7j",
            "digital_content": "https://salla.sa/dev-k9dn7fok0vih4p70/orders/digital/lm6bowYMnmA9eyWdLkJza153vyZnMb85QO0GZ7NxDlVKXB4grqR82jEN",
            "rating": "https://store-test.com/rating-link",
            "checkout": "https://store-test.com/checkout-link"
        },
        "date": {
            "date": "2024-02-15 08:23:05.000000",
            "timezone_type": 3,
            "timezone": "Asia/Riyadh"
        },
        "updated_at": {
            "date": "2024-02-15 11:23:05.000000",
            "timezone_type": 3,
            "timezone": "Asia/Riyadh"
        },
        "source": "store",
        "source_details": {
            "type": "direct",
            "value": null,
            "device": "desktop",
            "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36",
            "ip": "127.0.0.1"
        },
        "status": {
            "id": 1298199463,
            "name": "تم التنفيذ",
            "slug": "completed",
            "customized": {
                "id": 1633436842,
                "name": "طلبك بيوصلك قريب"
            }
        },
        "is_price_quote": false,
        "payment_method": "mada",
        "currency": "SAR",
        "amounts": {
            "sub_total": {
                "amount": 250,
                "currency": "SAR"
            },
            "shipping_cost": {
                "amount": 13.04,
                "currency": "SAR"
            },
            "cash_on_delivery": {
                "amount": 0,
                "currency": "SAR"
            },
            "tax": {
                "percent": "15.00",
                "amount": {
                    "amount": 39.46,
                    "currency": "SAR"
                }
            },
            "discounts": [
                {
                    "title": "New Coupon",
                    "type": "normal",
                    "code": "kb123",
                    "discount": "15.00",
                    "currency": "SAR",
                    "discounted_shipping": "0.00",
                    "hasMarketing": false
                }
            ],
            "total": {
                "amount": 302.5,
                "currency": "SAR"
            }
        },
        "can_cancel": false,
        "show_weight": true,
        "can_reorder": true,
        "is_pending_payment": false,
        "pending_payment_ends_at": 0,
        "total_weight": "٠٫٥١ كجم",
        "receiver": {
            "name": "أحمد Conn",
            "email": "demo@demo.com",
            "phone": "966501724227"
        },
        "customer": {
            "id": 1473353380,
            "first_name": "أحمد",
            "last_name": "Conn",
            "mobile": 501724227,
            "mobile_code": "+966",
            "email": "demo@demo.com",
            "urls": {
                "customer": "http://store.test/ar/hemo.store/profile",
                "admin": "/customers/x9oKNEzBmR3JlkMRYW6ZYd2q0QpPXy4n",
                "digital_content": "https://salla.sa/dev-k9dn7fok0vih4p70/orders/digital/lm6bowYMnmA9eyWdLkJza153vyZnMb85QO0GZ7NxDlVKXB4grqR82jEN"
            },
            "avatar": "https://cdn.assets.salla.network/prod/admin/cp/assets/images/avatar_male.png",
            "gender": "male",
            "birthday": {
                "date": "1970-01-01 00:00:00.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "city": "الرياض",
            "country": "السعودية",
            "country_code": "SA",
            "currency": "SAR",
            "location": "ابيض طويل",
            "updated_at": {
                "date": "2024-02-15 11:18:00.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            }
        },
        "bank": null,
        "tags": []
    }
}
🟢200Deprecated Response
🟠404Object Not Found
Modified at 2026-01-26 10:50:33
Previous
List Orders
Next
Create Drafted Order