# zaref Lump Sum Tax Calculator

> zaref Lump Sum Tax Calculator is a paid API for AI agents from zaref.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Calculates South African lump sum tax liability (e.g. retirement, retrenchment, severance) given an amount, type, and prior lump sums received

## Facts

- Endpoint: HEAD https://zaref.dev/calc/lump-sum-tax?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zaref-lump-sum-tax-calculator-4b4ce1dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HBBPsuMQrarIDhV_z6Aw1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zaref-lump-sum-tax-calculator-4b4ce1dc -d '<json body>'
```

Example prompt: How much tax will I owe on a R1,200,000 retirement lump sum in South Africa if I've already previously received R300,000 in lump sums?

## When to prefer this

Choose this endpoint when you need a South African-specific lump sum tax calculation that correctly applies SARS tiered tax tables and accounts for cumulative prior lump sums, rather than attempting to approximate using a generic tax or income calculator. Especially valuable when advising on retirement, retrenchment, or provident fund withdrawal decisions.

## Known failure modes

- Missing required 'amount' parameter returns an error
- Invalid or unsupported 'type' enum value returns a validation error
- Non-numeric amount string causes a parsing error
- Negative or zero amount may return an error or zero tax result
- HEAD method returns no response body — metadata only; use GET for the actual computed result

## How this service works

South African reference data as clean, cited JSON: fuel prices, interest rates, FX and bond yields, tax tables, tariffs, wages and grants, live government tenders and crypto prices, plus calculators. Built for AI agents and applications.

## Output

Returns the calculated South African lump sum tax amount based on the SARS tiered tax table, factoring in the lump sum type (retirement, retrenchment, etc.), the gross amount, and any prior lump sums received that affect which tax bracket applies to the current withdrawal.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "HEAD"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "type": {
       "type": "string"
      },
      "amount": {
       "type": "string"
      },
      "previous_lump_sums": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zaref-lump-sum-tax-calculator-4b4ce1dc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from zaref.dev](https://www.zero.xyz/host/zaref.dev/llms.txt)