# Turn Qiwa into an API for your establishment

> Read your establishment's contracts, violations and certificates from Qiwa with one API call each. Or have a workflow check Established Violations every morning and your certificates every week, and pass the changes to HR.

Page: https://fous.com/automate/qiwa
Updated: 2026-11-12

Works with your own Qiwa account. Fous is an independent product.

## What you can build on Qiwa

### Get employment contracts

Reads All Contracts in the Contract Management service and opens View details for each contract you ask about.

- Takes: Contract status (optional), employee ID (optional)
- Returns: Employee name, ID number, nationality, job title, contract status, start date, end date

### Check establishment violations

Reads the Established Violations service: the violations recorded against your establishment and whether each is paid or appealed.

- Takes: Recorded since (optional)
- Returns: Violation number, date, violation type, fine amount, status

### Check your establishment certificates

Reads Certifications: the localization (Saudization) certificate under Establishment Information, the Wage Protection one under Facility Management and Information.

- Takes: Nothing
- Returns: Certificate type, status, issue date, expiry date, certificate number

### Submit a contract termination request

Opens a contract's View details in Contract Management, selects Terminate contract, the employee and the reason, then the summary and Submit termination request.

- Takes: Employee ID, termination reason
- Returns: Employee name, contract status, termination reason, request status

## Automate Qiwa with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### New establishment violations, every morning

Starts: Every weekday at 8:00, Riyadh time

1. Check Established Violations for your establishment.
2. Keep the violations that were not there on the last run.
3. Post each one, with its number, date, type and fine amount, to your HR or finance webhook.

### Saudization and Wage Protection certificates, weekly

Starts: Every Sunday at 9:00, Riyadh time

1. Read the Certifications page for your establishment on Qiwa.
2. Keep the certificates that expire within 30 days or are no longer valid.
3. Email you the list with each certificate's type, status and expiry date.

### Contract changes, handed to your HR system

Starts: Every day at 18:00, Riyadh time

1. Get all contracts from Contract Management.
2. Keep the contracts whose status or end date changed since the last run.
3. Post them to your HR system's webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get employment contracts” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "qiwa.sa/get_employment_contracts",
    "input": {
      "contract_status": "Active"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "establishment": "Acme Trading Co.",
    "contracts": [
      {
        "employee_name": "Employee A",
        "id_number": "2XXXXXXXX1",
        "nationality": "Non-Saudi",
        "job_title": "Accountant",
        "contract_status": "Active",
        "start_date": "2025-03-01",
        "end_date": "2027-02-28"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## Qiwa’s own options

The Ministry of Human Resources and Social Development runs its establishment services through Qiwa: contracts, visas, employee transfers, violations and certificates. Its service guide describes each one as steps after you log in to your business account, and lists no public API for establishments. Certificates are issued free and at once.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Certifications in Qiwa | Issue, view and print the localization certificate and the Wage Protection compliance certificate. | A Qiwa business account. Free, issued immediately. |
| Ministry services guide | Each Qiwa service's purpose, fees, steps and conditions, and user guides such as Terminate an Employment Contract. | Public on hrsd.gov.sa. |
| Qiwa by hand | Contract Management, Established Violations, Employee Transfers, Instant Work Visas and Certifications, each used by hand on its own screens. | A Qiwa business account for the establishment. |

Read on November 12, 2026: [Issuance of a localization certificate](https://www.hrsd.gov.sa/en/ministry-services/services/%D8%A5%D8%B5%D8%AF%D8%A7%D8%B1-%D8%B4%D9%87%D8%A7%D8%AF%D8%A9-%D8%A7%D9%84%D8%AA%D9%88%D8%B7%D9%8A%D9%86), [User guide: Terminate an Employment Contract](https://www.hrsd.gov.sa/sites/default/files/2026-09/terminate-an-employment-contract---user-guide.pdf), [Violation of labor regulations](https://www.hrsd.gov.sa/en/ministry-services/services/%D9%85%D8%AE%D8%A7%D9%84%D9%81%D8%A9-%D9%86%D8%B8%D8%A7%D9%85-%D8%A7%D9%84%D8%B9%D9%85%D9%84).

## Signing in to Qiwa

The ministry's guides start every Qiwa service the same way: log in to your business account, as an establishment. With Fous you sign in once through Qiwa's own sign-in with your own account. The login is sealed with AES-256, never returned by the API or written to logs, and code and AI agents never see it.

## Worth knowing

- **Termination has conditions**: A contract can be terminated only while it is active, and for a non-Saudi worker the work permit must be valid for at least 60 days. Some reasons require the notice period, others take effect without notice.
- **Both sides can act on a contract**: Terminate an Employment Contract is available to the establishment and to the worker. The termination records the reason and effective date and updates the contract status across the integrated systems.
- **Certificates are issued in Certifications**: The localization certificate is under Establishment Information, then Certifications, and the Wage Protection certificate under Facility Management and Information, then Certifications. Both are free and issued immediately.
- **Transfers are for non-Saudi employees**: Employee Transfers moves non-Saudi employees from another employer in Saudi Arabia, or between your own establishments. You choose the establishment, add the employee's details and submit.

## More in Government: Middle East and Africa

- [CAC Company Registration Portal](https://fous.com/automate/cac-company-registration-portal.md)
- [CIPC eServices](https://fous.com/automate/cipc-eservices.md)
- [GDRFA Dubai Smart Services](https://fous.com/automate/gdrfa-dubai-smart-services.md)
- [eTIMS](https://fous.com/automate/etims.md)
- [Rev360](https://fous.com/automate/rev360.md)
- [ICP Smart Services](https://fous.com/automate/icp-smart-services.md)
- [KRA iTax](https://fous.com/automate/kra-itax.md)
- [SARS eFiling](https://fous.com/automate/sars-efiling.md)
- [SIMPL](https://fous.com/automate/simpl.md)
- [Egyptian Tax Authority e-Services](https://fous.com/automate/egyptian-tax-authority-e-services.md)
- [ZATCA e-Services](https://fous.com/automate/zatca-e-services.md)
- [uFiling](https://fous.com/automate/ufiling.md)
- [EmaraTax](https://fous.com/automate/emaratax.md)
- [Mudad](https://fous.com/automate/mudad.md)

Other industries: [UETS](/automate/uets), [net-entreprises.fr](/automate/net-entreprises-fr), [Metrc](/automate/metrc), [PEXA](/automate/pexa), [FMCSA Drug & Alcohol Clearinghouse](/automate/fmcsa-drug-and-alcohol-clearinghouse), [PlanetBids](/automate/planetbids).

## Frequently asked questions

### Does Qiwa have an API?

Not a public one for establishments, as far as the ministry's service guide shows. It describes each Qiwa service as steps after you log in to your business account, and certificates are issued and printed in Certifications. With Fous you can build a method that reads one of those screens and returns JSON.

### Where do I get my Saudization certificate on Qiwa?

In your business account, under Establishment Information, then Certifications. The localization certificate is issued and printed there, free and immediately. The Wage Protection compliance certificate is also issued from Certifications, under Facility Management and Information.

### How do I see and pay violations on Qiwa?

Open the Established Violations service from the Services tab. It shows the violations recorded against your establishment and lets you pay a fine or appeal it.

### Can I terminate an employment contract on Qiwa?

Yes, in Contract Management. Open the contract under All Contracts, select Terminate contract, choose the reason, review the summary and submit. The contract must be active, and for a non-Saudi worker the work permit must be valid for at least 60 days.

### Is Fous affiliated with the Ministry of Human Resources and Social Development?

No. Fous is an independent product. You use it with your own Qiwa business account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Qiwa (Ministry of Human Resources and Social Development). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.