List orders

GET

https://numueg.app/api/v1/stores/{store_id}/orders/

Last modified:2026-09-19 16:39:33

x-numu-scope:orders:read

List orders for a store with optional filtering and pagination.

For the specific case of "orders with an InstaPay proof awaiting
merchant review", use the dedicated endpoint
GET /stores/{store_id}/orders/pending-instapay-review instead
of a query param on this route. It runs a self-join on
payment_proofs so the server returns only rows where the
latest proof is awaiting_review — a condition this list
endpoint's repository layer can't express today.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//orders/?page=&limit=&status=&payment_status=&fulfillment_status=&date_from=&date_to=&search=&customer_id=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "items": [
            {
                "id": "string",
                "order_number": "string",
                "customer_id": "string",
                "customer_name": "string",
                "status": "string",
                "payment_status": "string",
                "fulfillment_status": "string",
                "total": 0,
                "collected_total": 0,
                "currency": "string",
                "item_count": 0,
                "payment_method": "string",
                "created_at": "string",
                "discount_amount": 0,
                "campaign": {
                    "id": "string",
                    "name": "string"
                },
                "customer_confirmation_status": "string",
                "customer_confirmed_at": "string",
                "shipping_method": "string",
                "tracking_number": "string"
            }
        ],
        "total": 0,
        "page": 0,
        "page_size": 0,
        "total_pages": 0
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Create new order

Create a draft order