Preview rates for a cart (merchant calculator tool)

POST

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

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

x-numu-scope:settings:write

Same shape as storefront /shipping/options — shares the resolver.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//shipping/calculate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "governorate_code": "string",
    "cart_subtotal_cents": 0,
    "cart_weight_g": 0,
    "cod_requested": false,
    "coupon_code": "string",
    "location_id": "46910cc3-ab41-4b80-b4a7-94dab9f1b795"
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "options": [
            {
                "rate_id": "3bec1d92-6fca-4949-9664-244f71111c20",
                "label": "string",
                "label_ar": "string",
                "amount_cents": 0,
                "currency": "string",
                "estimated_days_min": 0,
                "estimated_days_max": 0,
                "cod_supported": true,
                "rate_type": "flat"
            }
        ],
        "free_shipping_progress": {
            "current_cents": 0,
            "threshold_cents": 0,
            "remaining_cents": 0,
            "qualified": true
        },
        "unavailable_reason": "string"
    },
    "message": "string"
}

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

Apply the Quick Start: Egypt 4-zone preset

Get Balances