- 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
- Order Status
- Order Histories
- Order Options
- Order Assignment
- Order Invoice
- Products
- Order Reservations
- Product Tags
- Product Options
- Product Images
- Product Option Values
- Digitals Product
- Product Quantity
- Product Variants
- Settlements
- Customers
- Customer Groups
- Customer Wallet
- Abandoned Carts
- Special Offers
- Affiliates
- Coupons
- Reviews
- Feedbacks
- Order Items
- Branches
- Branches Allocations
- Shipments
- Shipping Companies
- Shipping Zones
- Shipping Routes
- Countries
- Districts
- Cities
- Product Option Templates
- Shipping Delivery Promises
- Categories
- Settings
- Store Scopes
- Brands
- Exports
- Transactions
- Payments
- Currencies
- Merchant
- Taxes
- SEO
- DNS Records
- Languages
- Employees
- Advertisements
- Webhooks
- Custom URLs
- Loyalty Points
- Branch Delivery Zones
- Webhooks
List Orders
Production
https://api.salla.dev/admin/v2
Production
https://api.salla.dev/admin/v2
GET
https://api.salla.dev/admin/v2
Last modified:2026-09-21 14:04:21
List Orders Pagination Guidelines
page=1, then page=2, page=3, and so on).page=10) will return an empty response.per_page=30 to reduce the total number of requests.from_date and to_date query parameters to retrieve smaller datasets and improve pagination performance.Breaking Change Notice
groups array under the customer object will be deprecated. Alternatively, you can use the Customer Details Endpoint to get the groups assigned to a specific customer.Deprecation Notice
expanded=true query parameter will no longer be supported.expanded=true query parameter.expanded response. (Expires at 1st of September 2026)Note
shipping_details_id inside the shipping object response matches the id returned by the shipping estimated rate endpoint.Scopes
orders.read - Orders Read OnlyRequest
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.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 'https://api.salla.dev/admin/v2/orders?keyword=&payment_method=&status=&from_date=&to_date=&country=&city=&product=&branch=&tags=&expanded=&page=&reference_id=&coupon=&customer_id=&shipping_app_id=&source=&sort_by=&accounting_services=&unread=&assign_employee=&selling_channel=&created_by=undefined' \
--header 'Authorization: Bearer <token>'Responses
🟢200Success
application/json
Bodyapplication/json
Examples
{
"status": 200,
"success": true,
"data": [
{
"id": 1333249299,
"external_reference_id": null,
"reference_id": 275839672,
"urls": {
"customer": "https://salla.sa/test_domin22may/account/orders/yDKpAjR",
"admin": "https://s.salla.sa/orders/order/kDXv9mr2bGzYaey9dKKzaKoPexnAwyl0"
},
"total": {
"amount": 16.39,
"currency": "SAR"
},
"exchange_rate": {
"base_currency": "SAR",
"exchange_currency": "SAR",
"rate": "1.00000000"
},
"scope_exchange_rate": null,
"date": {
"date": "2026-08-02 18:08:47.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"source": "store",
"status": {
"id": 1939592358,
"name": "قيد التنفيذ",
"slug": "in_progress",
"customized": {
"id": 923207662,
"name": "قيد التنفيذ"
}
},
"draft": false,
"read": true,
"can_cancel": false,
"can_reorder": false,
"payment_method": "credit_card",
"payment_methods": [
{
"amount": "10.93",
"payment_method": "bank",
"transaction_reference": null
},
{
"amount": "5.46",
"payment_method": "credit_card",
"transaction_reference": "9682442091042222"
}
],
"is_pending_payment": false,
"pending_payment_ends_at": 0,
"is_overweighted": false,
"features": {
"shippable": true,
"is_international": false,
"internationally_shippable": false,
"digitalable": true,
"pickable": false,
"has_suspicious_alert": false,
"bullet_delivery": {
"is_bullet_delivery": false,
"bullet_countdown": 0,
"on_demand_countdown": 0,
"on_demand_delivery": false,
"on_demand_timer": false
}
},
"gateway": null,
"payment_actions": {
"refund_action": {
"refunded_transactions": [],
"pending_refund_amount": null,
"has_refund_amount": false,
"payment_method_label": "البطاقة الإئتمانية",
"can_print_refund_invoice": false,
"paid_amount": {
"amount": 16.39,
"currency": "SAR"
},
"refund_amount": {
"amount": 0,
"currency": "SAR"
},
"loyalty_point_programs": [],
"can_send_sms": true,
"can_send_sms_msg": "يرجى تفعيل احد مزودين خدمة SMS من صفحة ربط الخدمات",
"can_refund_loyalty_prize_points": false,
"can_restore_loyalty_buy_from_store_points": false,
"can_refund_to_wallet": true
},
"remaining_action": {
"has_remaining_amount": false,
"payment_method_label": "البطاقة الإئتمانية",
"paid_amount": {
"amount": 16.39,
"currency": "SAR"
},
"checkout_url": "",
"remaining_amount": {
"amount": 0,
"currency": "SAR"
}
}
},
"items": [
{
"name": "Perfumes Package",
"quantity": 1,
"thumbnail": "https://cdn.salla.sa/oEGE/products/03zlnFLaLzY0GtowFR5RRLY566vJYzqHJpYB7ggg.png"
},
{
"name": "Dress",
"quantity": 1,
"thumbnail": null
}
],
"customer": {
"id": 19946325555,
"full_name": "Mohammed Ahmed",
"first_name": "Mohammed",
"last_name": "Ahmed",
"mobile": 557777777,
"mobile_code": "+966",
"email": "[email protected]",
"urls": {
"customer": "https://demostore.salla.sa/dev-qemdv5vldnohhhpq/account/profile",
"admin": "https://s.salla.sa/customers/zAB3exRyLdXv5Wpk5lDarGg4p7Ej8ZKl"
},
"avatar": "https://cdn.assets.salla.network/prod/admin/cp/assets/images/avatar_female.png",
"gender": "female",
"birthday": {
"date": "1987-08-12 00:00:00.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"city": "الحميمة",
"country": "السعودية",
"country_code": "SA",
"currency": "SAR",
"location": "",
"lang": "ar",
"created_at": {
"date": "2025-12-25 12:41:10.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"updated_at": {
"date": "2026-08-23 17:02:59.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"type": "user",
"groups": []
}
},
{
"id": 19238428888,
"external_reference_id": null,
"reference_id": 281659564,
"urls": {
"customer": "https://salla.sa/test_domin22may/account/orders/Prr",
"admin": "https://s.salla.sa/orders/order/4GV9LQN3veZl1PZ5vVl9WBR6rJ5kzEoo"
},
"total": {
"amount": 104.15,
"currency": "SAR"
},
"exchange_rate": {
"base_currency": "SAR",
"exchange_currency": "SAR",
"rate": "1.00000000"
},
"scope_exchange_rate": null,
"date": {
"date": "2026-08-31 17:04:00.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"source": "store",
"status": {
"id": 566146469,
"name": "بإنتظار المراجعة",
"slug": "under_review",
"customized": {
"id": 1698363629,
"name": "بإنتظار المراجعة"
}
},
"draft": false,
"read": true,
"can_cancel": false,
"can_reorder": false,
"payment_method": "cod",
"payment_methods": [
{
"amount": 0,
"payment_method": "cod",
"transaction_reference": null
}
],
"is_pending_payment": false,
"pending_payment_ends_at": 0,
"is_overweighted": false,
"features": {
"shippable": true,
"is_international": false,
"internationally_shippable": false,
"digitalable": false,
"pickable": false,
"has_suspicious_alert": false,
"bullet_delivery": {
"is_bullet_delivery": false,
"bullet_countdown": 0,
"on_demand_countdown": 0,
"on_demand_delivery": false,
"on_demand_timer": false
}
},
"gateway": null,
"payment_actions": {
"refund_action": {
"refunded_transactions": [],
"pending_refund_amount": null,
"has_refund_amount": false,
"payment_method_label": "دفع عند التسليم",
"can_print_refund_invoice": false,
"paid_amount": {
"amount": 0,
"currency": "SAR"
},
"refund_amount": {
"amount": 0,
"currency": "SAR"
},
"loyalty_point_programs": [],
"can_send_sms": true,
"can_send_sms_msg": "",
"can_refund_loyalty_prize_points": false,
"can_restore_loyalty_buy_from_store_points": false,
"can_refund_to_wallet": true
},
"remaining_action": {
"has_remaining_amount": false,
"payment_method_label": "دفع عند التسليم",
"paid_amount": {
"amount": 0,
"currency": "SAR"
},
"checkout_url": "",
"remaining_amount": null
}
},
"items": [
{
"name": "ورد احمر",
"quantity": 1,
"thumbnail": "https://cdn.salla.sa/oEGE/938c1b33-d877-4018-abe6-b5cbd765ad83-500x374.51737451737-ib1mUOvL3lq1zccCQiAnPrRsJ23KshubeO2eDKOS.jpg"
}
],
"customer": {
"id": 1994632555,
"full_name": "Mohammed Ahmed",
"first_name": "Mohammed",
"last_name": "Ahmed",
"mobile": 553333333,
"mobile_code": "+966",
"email": "[email protected]",
"urls": {
"customer": "https://demostore.salla.sa/dev-qemdv5vldnohhhpq/account/profile",
"admin": "https://s.salla.sa/customers/zAB3exRyLdXv5Wpk5lDarGg4p7Ej8ZKl"
},
"avatar": "https://cdn.assets.salla.network/prod/admin/cp/assets/images/avatar_female.png",
"gender": "female",
"birthday": {
"date": "1987-08-12 00:00:00.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"city": "الحميمة",
"country": "السعودية",
"country_code": "SA",
"currency": "SAR",
"location": "",
"lang": "ar",
"created_at": {
"date": "2025-12-25 12:41:10.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"updated_at": {
"date": "2026-08-23 17:02:59.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"type": "user",
"groups": []
}
}
],
"pagination": {
"count": 2,
"total": 1216,
"perPage": 2,
"currentPage": 1,
"totalPages": 608,
"links": {
"next": "http://api.salla.dev/admin/v2/orders?per_page=2&page=2"
}
}
}🟠401Unauthorized
Modified at 2026-09-21 14:04:21