Get your uFiling declarations through an API

What you can build on uFiling

• Get declaration history for an employer

  Build this

  Opens the employer in Declarations Manager, selects View Returns and Calculate Returns, and reads the five-year list of periods with each one's status.

  Takes

  UIF reference number

  Returns

  Employer, period, status, issue, contribution amount

• List an employer's employees

  Build this

  Reads the employee list on the employer's Employment Summary in Declarations Manager, with each employee's employment and salary information.

  Takes

  UIF reference number

  Returns

  Employee name, ID number, commencement date, termination date, UIF taxable remuneration, UIF gross remuneration

• Get payment history

  Build this

  Reads the Payment History page: every electronic and manual payment, with its status, which reads PAID once the transaction has cleared.

  Takes

  UIF reference number, from period (optional)

  Returns

  Employer, period, payment type, amount, payment date, status

• Submit a monthly declaration

  Build this

  Opens the period under View Returns for one employer, checks the declaration values and selects Submit, so the status changes to Submitted.

  Takes

  UIF reference number, period

  Returns

  Employer, period, status, number of employees, contribution amount

Automate uFiling 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.

• Missing declarations, every employer you file for

  Build this

  Starts

  Every month on the 8th at 8:00, Africa/Johannesburg

  Step 1

  For each UIF reference number you list, get the employer's declaration history.

  Step 2

  Keep the periods that are not Submitted or that show an issue.

  Step 3

  Email you the list, one section per employer, with period, status and issue.

• Cleared UIF payments, posted to your accounting system

  Build this

  Starts

  Every weekday at 9:00, Africa/Johannesburg

  Step 1

  For each employer, get the Payment History.

  Step 2

  Keep the payments that are PAID now and were not PAID on the last run.

  Step 3

  Post employer, period, amount, payment type and payment date to your accounting webhook.

• Employee records that changed, sent to your payroll system

  Build this

  Starts

  Every month on the 1st at 7:00, Africa/Johannesburg

  Step 1

  For each employer, list the employees and their UIF taxable remuneration.

  Step 2

  Keep the employees added, terminated or changed since the last run.

  Step 3

  Post them to your payroll system's webhook so the records match before you declare.

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 declaration history for an employer” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "ufiling.labour.gov.za/get_declaration_history",
    "input": {
      "uif_reference": "2501234/8"
    }
  }'

{
  "status": "completed",
  "data": {
    "employer": "Acme Cleaning (Pty) Ltd",
    "uif_reference": "2501234/8",
    "periods": [
      {
        "period": "2026-10",
        "status": "Submitted",
        "issue": null,
        "contribution_amount": 4812.6,
        "currency": "ZAR"
      }
    ],
    "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.

UFiling’s own options

uFiling is free, and its user guide and FAQ describe no API or data export. Employers, labour practitioners and their delegates declare and pay UIF contributions in the portal, one employer at a time. Employees can be added in bulk from an Excel upload file, and payments go to your bank as an instruction you approve.

Read on November 12, 2026: uFiling System User Guide, uFiling FAQs, Instructed Debit Pull.

Signing in to uFiling

uFiling signs you in with a username and password. A new account gets a temporary password by email or SMS, asks for a new one at first sign-in and then a vetting step. With Fous you sign in once through uFiling's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

Declarations follow the employee records

uFiling prepares each declaration from the employer and employee details you captured. A declaration cannot be edited itself: you correct the employee's employment or salary details, and the declaration follows.

Due by the 7th, changeable until paid

Employers send the UIF their employees' details by the 7th of every month. A return can be changed until it is paid, a payment cannot be reversed, and a correction to an earlier period goes into the next month.

One employer at a time

uFiling has no consolidated view of all clients, and reports are per employer. Adding a client sends the employer an approval email, and the request stays Pending until it is accepted.

Payments need your bank's approval

Pay Online For Period sends an instruction you approve in your banking app, and the bank usually answers within 24 to 48 hours. Penalties and interest cannot be paid through uFiling.

More in Government: Middle East and Africa

• CAC Company Registration Portal
• CIPC eServices
• GDRFA Dubai Smart Services
• eTIMS
• Rev360
• Qiwa
• ICP Smart Services
• KRA iTax
• SARS eFiling
• SIMPL
• Egyptian Tax Authority e-Services
• ZATCA e-Services
• EmaraTax
• Mudad

Other industries: TRACES NT, Companies House WebFiling, LOOP, Halifax Intermediaries Online, FBI NICS E-Check, PASSPort.