Developers
The employment API for South Africa
Onboard, pay and offboard South African employees with a REST API. Public docs, sandbox from day one. No sales call required to read them.
Capabilities
POST /v1/employments
Onboard in one call
Send candidate, role and salary; we handle contract and registrations.
PATCH /v1/employments/:id
Manage payroll variables
Compensation, bonuses, expenses and leave, validated against payroll cutoffs.
DELETE /v1/employments/:id
Offboard compliantly
Terminations enter mandatory specialist review; the API tracks the case to completion.
POST /v1/quotes
Quote in real time
The public quotes endpoint that powers our calculator.
POST /v1/quotes
One engine, no drift
Our public calculator runs on the same endpoint you can call. Marketing numbers and API numbers always agree.
- · Versioned API (/v1/)
- · Sandbox with simulated payroll
- · Signed webhooks (Ed25519)
- · OpenAPI 3.1 download
- · Status page
curl https://api.expandtosouthafrica.com/v1/quotes \
-H 'Authorization: Bearer sk_sandbox_...' \
-H 'Content-Type: application/json' \
-d '{
"grossSalaryZarMonthly": 45000,
"benefitsTier": "standard",
"displayCurrency": "EUR"
}'
# Response (abridged):
# {
# "totalMonthly": "€2 722",
# "currency": "EUR",
# "lines": { "salary": …, "statutory": …, "fee": 350 }
# }
Sandbox access
Get sandbox keys
Tell us what you plan to build and we'll send sandbox keys, the docs URL and the OpenAPI 3.1 spec. Sandbox is self-serve and simulated; live keys are issued after a signed agreement.
Have a candidate?
Employ them for €350/month
Compliant contract, payroll and benefits via our licensed partner. Onboarded in days.
Book a call
Need talent first?
We source vetted SA professionals
Brief us on the role; meet a shortlist within two weeks. Then employ through the platform.
Explore talent sourcing