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. 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
    • 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
    • Order Items
      • List Order Items
      • Create Order Item
      • Update Order Item
      • Delete Order Item
    • 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
      • List Product Quantities
      • Update Bulk Quantities
      • List Quantity Change Reasons
      • List Quantity Audit
      • Update Bulk Quantities by SKU
      • Update Quantity
      • Update Quantity By SKU
    • 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
    • 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
    • Shipments
      • Create Shipment
      • List Shipments
      • Shipment Details
      • Shipment Tracking
      • Update Shipment Details
      • Cancel Shipment
      • Return Shipment
    • Shipping Companies
      • List Shipping Companies
      • Shipping Company Details
      • List Estimate Rates
      • Create Shipping Company
      • Update Shipping Company
      • Delete Shipping Company
      • Shipping Company Options
    • 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
    • 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
      • List Special Offers
      • Special Offer Details
      • Update Special Offer
      • Delete Special Offer
      • Change Special Offer Status
    • Transactions
      • List Transactions
      • Transaction Details
      • Update Transaction
    • Payments
      • Available Payment Methods
      • List Banks
      • Payment Bank Details
    • Settlements
      • List Instant Settlements
      • Create Instant Settlement
      • Update Instant Settlement
      • Instant Settlement Details
    • Settings
      • Settings List
      • Update Setting Slug
      • Setting 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
    • 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
    • Order
    • Product
    • Customer
    • Shippings
    • Shipments
    • Brand
    • Invoice
    • Category
    • Store
    • Special Offer
    • Cart
    • Miscellaneous
  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}
Orders
Last modified:2025-05-08 13:09:45
This endpoint allows you to return the details for a specific order by passing the order_id as a path parameter.
Deprecation Notice
The variables data.checkout_url and data.rating_link will be deprecated by May 25, 2025. Moving forward, they will be accessible under the urls object as data.urls.checkout and data.urls.rating.
The extended response will be deprecated soon. We urge you to use the format=light query parameter to fetch the to-be default response.
Note
• You are also 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.
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
order_id
integer 
required
The Order ID
Example:
3155923424
Query Params
format
enum<string> 
required
Use the format query parameter to return Order details without the following objects:
Shipments
Items
Pickup Branch
Customer Groups
Allowed value:
light
Example:
light

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/orders/3155923424?format=light'

Responses

🟢200Default Response
application/json
Body
status
integer 
optional
Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.
success
boolean 
optional
Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.
data
object (OrderDetails) 
optional
id
integer 
required
A unique alphanumeric code or identifier assigned to a specific order. List of Order ID can be found here.
checkout_id
integer 
required
A unique identifier assigned to a specific checkout session or transaction.
reference_id
integer 
required
Order reference ID, a specific alphanumeric code or identifier associated with an order, used for easy and precise reference and tracking of that particular order, this reference ID appears to customers in the store.
features
object 
required
actions
object 
required
urls
object (Urls) 
required
To help companies and merchants, Salla provides a “urls” attribute that has been added to different modules to guide the merchants to have the full URL of this module from both scopes, the dashboard scope as a store admin, and as a customer.
date
object (Date) 
required
updated_at
object (Date) 
required
source
string 
required
The origin or channel through which an order was placed.
source_details
object 
required
status
object (NewOrderStatus) 
required
is_price_quote
boolean 
required
payment_method
string 
required
The specific payment option or financial mechanism chosen and used by a customer to pay for a product or service as part of an order, encompassing various methods.
currency
string 
required
The specific type of currency or monetary unit in which the total cost and prices associated with an order are expressed and processed, typically based on the preferences and location of the customer or the business's operational currency.
amounts
object 
required
can_cancel
boolean 
required
The option to enable order cancellation by the store customer.
True value should be set if the order status is in under review and in progress, as according to the store settings.
show_weight
boolean 
required
The option to show the weight value.
can_reorder
boolean 
required
The option to enable reorder .
is_pending_payment
boolean 
required
The option of displaying order is pending payment to the customer when the order status is payment_pending.
checkout_url
string 
deprecated
The checkout URL to settle payments related to the order.
🛑 The variable is to be deprecated; use data.urls.checkout variable instead.
rating_link
string 
deprecated
The rating URL to review the order.
🛑 The variable is to be deprecated; use data.urls.rating variable instead.
pending_payment_ends_at
integer 
required
Last date allowed to customer to pay the order.
total_weight
string 
required
Total weight value
receiver
object 
required
customer
object 
required
bank
object 
required
tags
array[object (OrderTag) {2}] 
required
Example
{
  "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
    },
    "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": [],
      "total": {
        "amount": 302.5,
        "currency": "SAR"
      }
    },
    "can_cancel": false,
    "show_weight": true,
    "can_reorder": true,
    "is_pending_payment": false,
    "rating_link": "https://store-test.com/rating-link",
    "checkout_url": "https://store-test.com/checkout-link",
    "pending_payment_ends_at": 0,
    "total_weight": "٠٫٥١ كجم",
    "receiver": {
      "name": "أحمد Conn",
      "email": "[email protected]",
      "phone": "966501724227"
    },
    "customer": {
      "id": 1473353380,
      "first_name": "أحمد",
      "last_name": "Conn",
      "mobile": 501724227,
      "mobile_code": "+966",
      "email": "[email protected]",
      "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 2025-05-08 13:09:45
Previous
List Orders
Next
Create Drafted Order