Skip to main content
GET
/
api
/
v1
/
hub
/
shop
/
{shopId}
/
order
List Orders
curl --request GET \
  --url https://api.sabivendor.com/api/v1/hub/shop/{shopId}/order \
  --header 'X-Shop-API-Key: <x-shop-api-key>'
{
  "status": "success",
  "data": [
    {
      "id": 501,
      "reference": "ORD-501-ABCDE",
      "customerName": "Jane Doe",
      "customerPhoneNumber": "08012345678",
      "totalPriceKobo": 1250000,
      "orderStatus": "pending",
      "paymentStatus": "pending",
      "createdAt": "2026-06-19T14:30:00.000Z"
    }
  ]
}
Retrieves a paginated list of all store orders. Supports filtering by payment status and order fulfillment status.

​
Authorizations

​
X-Shop-API-Key
string
required
Your Secret API Key (sk_live_... or sk_test_...) generated from the Developer dashboard. Must be kept secret.

​
Path Parameters

​
shopId
string
required
The unique UUID of the shop.

​
Query Parameters

​
limit
number
default:"20"
Number of items to return.
​
offset
number
default:"0"
Offset for pagination.
​
orderStatus
string
Filter status: pending, confirmed, shipped, delivered, cancelled.
​
paymentStatus
string
Filter status: pending, paid, refunded, failed.
{
  "status": "success",
  "data": [
    {
      "id": 501,
      "reference": "ORD-501-ABCDE",
      "customerName": "Jane Doe",
      "customerPhoneNumber": "08012345678",
      "totalPriceKobo": 1250000,
      "orderStatus": "pending",
      "paymentStatus": "pending",
      "createdAt": "2026-06-19T14:30:00.000Z"
    }
  ]
}