Turn Qiwa into an API for your establishment

What you can build on Qiwa

• Get employment contracts

  Build this

  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

  Build this

  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

  Build this

  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

  Build this

  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 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

  Build this

  Starts

  Every weekday at 8:00, Riyadh time

  Step 1

  Check Established Violations for your establishment.

  Step 2

  Keep the violations that were not there on the last run.

  Step 3

  Post each one, with its number, date, type and fine amount, to your HR or finance webhook.

• Saudization and Wage Protection certificates, weekly

  Build this

  Starts

  Every Sunday at 9:00, Riyadh time

  Step 1

  Read the Certifications page for your establishment on Qiwa.

  Step 2

  Keep the certificates that expire within 30 days or are no longer valid.

  Step 3

  Email you the list with each certificate's type, status and expiry date.

• Contract changes, handed to your HR system

  Build this

  Starts

  Every day at 18:00, Riyadh time

  Step 1

  Get all contracts from Contract Management.

  Step 2

  Keep the contracts whose status or end date changed since the last run.

  Step 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, 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.

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"
    }
  }'

{
  "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.

Read on November 12, 2026: Issuance of a localization certificate, User guide: Terminate an Employment Contract, Violation of labor regulations.

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
• CIPC eServices
• GDRFA Dubai Smart Services
• eTIMS
• Rev360
• ICP Smart Services
• KRA iTax
• SARS eFiling
• SIMPL
• Egyptian Tax Authority e-Services
• ZATCA e-Services
• uFiling
• EmaraTax
• Mudad

Other industries: UETS, net-entreprises.fr, Metrc, PEXA, FMCSA Drug & Alcohol Clearinghouse, PlanetBids.