List Orders - Salla Merchant API

This endpoint allows you to list all orders related to your store.

List Orders Pagination Guidelines

To ensure reliable pagination results, follow these recommendations:

Retrieve pages sequentially (page=1, then page=2, page=3, and so on).

Do not skip pages. Requesting a page out of sequence (for example, jumping directly to page=10) will return an empty response.

Use the maximum page size by setting per_page=30 to reduce the total number of requests.

Complete pagination within 15 minutes. Sequential page requests are cached for a 15-minute window.

Filter by date whenever possible. Use the from_date and to_date query parameters to retrieve smaller datasets and improve pagination performance.

Breaking Change Notice

Effective 18th February 2026, the 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

All Apps created after 15th of August, 2024 will not be able to use theexpanded query parameter.

Note

• 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

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

ExampleUnauthorized

{
    "status": 200,
    "success": true,
    "data": [
        {
            "id": 1017120475,
            "reference_id": 40497536,
            "total": {
                "amount": 55,
                "currency": "SAR"
            },
            "exchange_rate": {
                "base_currency": "SAR",
                "exchange_currency": "USD",
                "rate": 0.266592
            },
            "date": {
                "date": "2022-06-16 14:48:20.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "status": {
                "id": 566146469,
                "name": "بإنتظار المراجعة",
                "slug": "under_review",
                "customized": {
                    "id": 986688842,
                    "name": "بإنتظار المراجعة"
                }
            },
            "can_cancel": false,
            "can_reorder": true,
            "payment_method": "bank",
            "is_pending_payment": false,
            "pending_payment_ends_at": 0,
            "features": {
                "digitalable": true,
                "shippable": true,
                "has_suspicious_alert": false
            },
            "items": [
                {
                    "name": "تي شيرت بلاك",
                    "quantity": 1,
                    "thumbnail": "https://salla-dev.s3.eu-central-1.amazonaws.com/Mvyk/c151972a-c2d1-4a4d-b374-b46fd0bca79e-500x333.33333333333-WfHaI7WVXTosOlksBhesYbWlxhMFf9fJVDK6JlJj.jpg"
                }
            ]
        },
        {
            "id": 1013578136,
            "reference_id": 40497469,
            "total": {
                "amount": 0,
                "currency": "SAR"
            },
            "date": {
                "date": "2022-06-16 14:46:42.000000",
                "timezone_type": 3,
                "timezone": "Asia/Riyadh"
            },
            "status": {
                "id": 525144736,
                "name": "ملغي",
                "slug": "canceled",
                "customized": {
                    "id": 1718741844,
                    "name": "ملغي"
                }
            },
            "can_cancel": false,
            "can_reorder": true,
            "is_pending_payment": true,
            "pending_payment_ends_at": 0,
            "items": [
                {
                    "name": "Custom Shirt",
                    "quantity": 3
                }
            ]
        }
    ],
    "pagination": {
        "count": 2,
        "total": 2,
        "perPage": 15,
        "currentPage": 1,
        "totalPages": 1,
        "links": {}
    }
}

🟠401Unauthorized