# Add Saudi Arabia Working Days

> Adds or subtracts Saudi Arabia authority-scope working days in exact coverage.

- Calculator id: `saudi-financial-add-working-days` · Category: Everyday Life (`everyday`) · Tool name: `add_sa_working_days`
- Canonical page: https://tttkmbb.com/everyday/saudi-financial-add-working-days · This document: https://tttkmbb.com/everyday/saudi-financial-add-working-days.md · JSON definition: https://tttkmbb.com/everyday/saudi-financial-add-working-days.json

## Purpose

Adds or subtracts Saudi Arabia authority-scope working days in exact coverage.

**Use when:** You need a deterministic Saudi Arabia working-day offset.

**Do not use when:** Financial-institution scope only. MHRSD business-sector leave, RTGS-specific intervals, government offices, private-employer rosters, Hajj-season branch exceptions and Umm al-Qura forecasts are not inferred.

## Example user requests

- Add or subtract Saudi Arabia working days around SAMA Eid Al-Fitr interval.
- Add or subtract Saudi Arabia working days around Friday/Saturday weekly baseline.
- Add or subtract Saudi Arabia working days around National Day Saturday substitution.


## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `start_date` | date |  | required | Gregorian start date in 2026-2029. |
| `working_days` | integer |  | required | Signed offset; start date excluded for non-zero offsets. (min -1000, max 1000) |

## Output

| Field | Type | Unit | Description |
| --- | --- | --- | --- |
| `start_date` | date |  | Input date. |
| `result_date` | date |  | Date reached. |
| `working_days_added` | integer |  | Signed requested offset. |
| `calendar_days_elapsed` | integer |  | Signed Gregorian difference. |
| `public_holidays_skipped` | list |  | Exact events crossed. |
| `territory` | string |  | SA (Saudi Arabia). |
| `territory_name` | string |  | Saudi Arabia |
| `day_type` | string |  | Deterministic classification: official_weekend, regular_workday, or the first published authority event kind. |
| `holiday_names` | string_list |  | Events applying on the date. |
| `holiday_kinds` | string_list |  | Authority event classifications. |
| `holiday_details` | list |  | Structured event details, including partial-day notes where published. |
| `calendar_scope` | string |  | Saudi Central Bank financial institutions |
| `holiday_policy` | string |  | Exact SAMA financial-institution holiday intervals plus the annual National Day and Founding Day rules. |
| `substitute_day_policy` | string |  | SAMA states that National Day or Founding Day on Friday moves to Thursday and on Saturday moves to Sunday; the 2028 National Day substitute is included. Other employer or RTGS substitutions are not inferred. |
| `calendar_profile` | string |  | saudi-sama-financial-holidays |
| `dataset_version` | string |  | sa-sama-financial-holidays-2026-2029.1 |
| `sources` | list |  | Authority and legislation sources. |

## Formula

`move one day at a time; decrement only on status.is_working_day=true`

Skip Saturday/Sunday and exact pinned authority events; do not add unverified substitute days.

## Data Sources

- Saudi Central Bank (SAMA) – holidays and working hours — https://www.sama.gov.sa/en-US/Supervision/Pages/holidayschedules.aspx (central_bank_official_calendar)
- Saudi MHRSD – holidays and leaves — https://www.hrsd.gov.sa/en/knowledge-centre/articles/322 (labour_authority_guidance)
- Saudi MHRSD – 2026 Foundation Day — https://www.hrsd.gov.sa/en/media-center/news/%D8%A5%D8%AC%D8%A7%D8%B2%D8%A9-%E2%81%A7%E2%80%AB%D9%8A%D9%88%D9%85-%D8%A7%D9%84%D8%AA%D8%A3%D8%B3%D9%8A%D8%B3 (labour_authority_announcement)

Data freshness: `static`. Pinned sa-sama-financial-holidays-2026-2029.1 package.

## API

- `GET https://tttkmbb.com/api/v1/calculate/saudi-financial-add-working-days?start_date=…&working_days=…`
- `POST https://tttkmbb.com/api/v1/calculate/saudi-financial-add-working-days` with JSON body `{"inputs": {…}}`
- Response: unified envelope (`success`, `request`, `result.values`, `result.units`, `sources`, `freshness`, `timestamp`, `next_actions`, `links`); see https://tttkmbb.com/docs/response-format.md
- Schema: https://tttkmbb.com/api/v1/calculators/saudi-financial-add-working-days · OpenAPI operationId `add_sa_working_days` in https://tttkmbb.com/openapi.json
- Authentication: none. Rate limit: fair use, see https://tttkmbb.com/docs/rate-limits.md.

## MCP

- Server: `https://tttkmbb.com/mcp` (Streamable HTTP, JSON-RPC 2.0, no auth)
- Tool:  `run_calculator` with `{"calculator_id": "saudi-financial-add-working-days", "inputs": {…}}`

## Example

- Zero offset is identity: inputs `{"start_date":"2026-01-01","working_days":0}` → `{"result_date":"2026-01-01","working_days_added":0}`

```
GET https://tttkmbb.com/api/v1/calculate/saudi-financial-add-working-days?start_date=2026-01-01&working_days=0
```

## Limitations

Financial-institution scope only. MHRSD business-sector leave, RTGS-specific intervals, government offices, private-employer rosters, Hajj-season branch exceptions and Umm al-Qura forecasts are not inferred. Skip Saturday/Sunday and exact pinned authority events; do not add unverified substitute days. All values are computed from the formula above; no measurement or live data is involved.

## FAQ

**Does this answer every Saudi employer?**

No. It is the SAMA financial-institution calendar. MHRSD business-sector rules, RTGS dates and employer schedules are separate scopes.

## Related

- [Saudi Arabia Working Day](https://tttkmbb.com/everyday/saudi-financial-working-day.md) — Inspect a date and source evidence.