Gulf end-of-service gratuity, calculated for your users

Add a GCC gratuity calculator to your HR portal, payroll product or employee handbook with one line of code, or call one JSON endpoint from your own system. Every result cites the law it is based on.

Live demo

This is the widget exactly as your visitors will see it, loaded with the same one-line snippet.

Coverage

All six countries are computed from each country's own labour law (Saudi Arabia, UAE, Kuwait, Qatar, Bahrain and Oman). The Kuwait result assumes employer-initiated termination unless a resignation reason is passed.

Embed in one line

Paste this where the calculator should appear. It resizes itself to fit.

<script src="https://mashashat.com/embed/v1.js"
  data-country="ae" data-key="YOUR_KEY" data-accent="0f766e" async></script>

If your CMS strips scripts, use the iframe directly:

<iframe src="https://mashashat.com/embed/gratuity/?country=ae&key=YOUR_KEY"
  style="width:100%;height:560px;border:0" title="Gratuity calculator"></iframe>

Options

• data-country: ae, sa, kw, qa, bh or om. Sets the starting country.
• data-lock="1": hides the country picker.
• data-accent: your brand colour as six hex digits, without the #.
• data-title: heading shown above the form, up to 60 characters.
• data-compact="1": hides the calculation breakdown.
• data-key: your license key. It removes the attribution line.

JSON API

One endpoint, the same engine as the widget. CORS is open, so you can call it from a browser or a server.

curl "https://api.mashashat.com/v1/gratuity?country=ae&wage=10000&months=72" \
  -H "Authorization: Bearer YOUR_KEY"

Parameters

• country: ae, sa, kw, qa, bh or om.
• wage: monthly basic wage in local currency.
• months: total months of continuous service.

Response

{
  "ok": true,
  "result": {
    "country": "ae", "currency": "AED",
    "monthlyWage": 10000, "serviceMonths": 72, "totalYears": 6,
    "gratuity": 45000,
    "noEntitlement": false, "noEntitlementReason": null,
    "cap": { "months": 24, "amount": 240000 }, "isCapped": false,
    "tiers": [
      { "id": "first_five_years", "years": 5, "rate": { "value": 21, "unit": "days_per_year" }, "amount": 35000 },
      { "id": "after_five_years", "years": 1, "rate": { "value": 30, "unit": "days_per_year" }, "amount": 10000 }
    ],
    "law": { "name": "Federal Decree-Law No. 33 of 2021 (Labour Relations)", "article": "Art. 51", "url": "https://www.mohre.gov.ae/" },
    "accuracy": "verified", "assumptions": ["..."], "engineVersion": "2026.2"
  },
  "meta": { "tier": "pro", "disclaimer": "..." }
}

Errors and limits

• 400 with code invalid_country, invalid_wage or invalid_months.
• 401 invalid_key when a key is sent but not recognised.
• 429 rate_limited above 30 requests per minute without a key.
• Send your key as Authorization: Bearer YOUR_KEY or ?key=.
• /v1 is stable. New fields may be added; existing fields will not change meaning.

Pricing

Questions

Is this legal advice?

No. Results are estimates based on the published statute and stated assumptions, such as basic wage only and employer-initiated termination. They are provided without warranty. You remain responsible for the amounts you pay and should confirm edge cases with your own counsel.

Do you store employee data?

No. The widget calculates inside the visitor's browser. The API does not log wage or service values.

What happens when a law changes?

We update the engine and bump its version, which every result reports in engineVersion, so you can tell which rules produced a number.

Can you add a country, an Arabic version or a custom field?

Email info@mashashat.com. Arabic and right-to-left layout are on the roadmap.