Countries With Provinces

Returns the list of countries with their provinces.

Endpoint

POST https://partners.waffarx.com/api/ValuCheckout/getcountrieswithprovinces

Request Headers

Header	Description
wxc-id	Your WaffarX Client Id
wxc-auth	Signature auth header for the request
wxc-date	UTC timestamp of the request, e.g. 2025-04-30T15:00:00Z
Accept-Language	Response language preference (e.g. en | ar)
Content-Type	Must be application/json

Note

wxc-id: The WaffarX client ID specified in your integration data.

Request Parameters

Name	Type	Required	Description
StoreId	string		The storeId which the order is being placed.

Request Body

Example Request Body

{
  "StoreId":"d413a-a1db-4da6-987e-83b8ffe17" /* ← Optional */
}

cURL Example

curl -X POST "https://partners.waffarx.com/api/ValuCheckout/getcountrieswithprovinces" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: en" \
  -H "wxc-id: {YOUR_CLIENT_ID}" \
  -H "wxc-date: 2025-05-04T21:58:34Z" \
  -H "wxc-auth: 712310e9379796869cf4915ef3e418f1f7fa45cf508aef44020cce" \
  -d '{"StoreId": "d413a-a1db-4da6-987e-83b8ffe17"}'

Responses

Success (HTTP 200)

Success Response Example

  {
    "status": "Success",
    "data": {
        "countries": [
            {
                "id": "68c04f694b3cff720039559b",
                "name": "EGYPT",
                "nameAr": "مصر",
                "code": "EG",
                "provinces": [
                    {
                        "id": "68c05461309c2cff8025d4b8",
                        "name": "Al Sharqia",
                        "nameAr": "الشرقية",
                        "code": "SHR",
                        "countryId": "68c04f694b3cff720039559b",
                        "cities": [
                            {
                                "cityId": "306",
                                "name": "Zagazig",
                                "nameAr": "الزقازيق"
                            }
                        ]
                    },
                    {
                        "id": "68c05461309c2cff8025d4b9",
                        "name": "Alexandria",
                        "nameAr": "الإسكندرية",
                        "code": "ALX",
                        "countryId": "68c04f694b3cff720039559b",
                        "cities": [
                            {
                                "cityId": "93",
                                "name": "Abu Qir",
                                "nameAr": "ابو قير"
                            }
                        ]
                    }
                ]
            }
        ],
        "totalCountries": 1,
        "totalProvinces": 28,
        "message": "Retrieved 1 countries with 28 total provinces"
    },
    "message": null,
    "errors": null
  }

Error (HTTP 4XX/5XX)

Error Response Example

  {
    "Status": "Error",
    "Data": null,
    "Message": null,
    "Errors": []
  }