# zaref Income Tax Calculator

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

Calculates South African personal income tax liability, rebates, and medical credits for a given annual taxable income, age, and medical scheme membership

## Facts

- Endpoint: POST https://zaref.dev/v1/answers/income-tax?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zaref-income-tax-calculator-f77b0df9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cmWycG9sA3o7QRewaFzMn

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-income-tax-calculator-f77b0df9 -d '<json body>'
```

Example prompt: What's my South African income tax for a R750,000 annual income, I'm 45 years old and have 3 medical scheme members including myself with 1 additional dependant?

## When to prefer this

Choose this endpoint when you need accurate, up-to-date South African personal income tax calculations including age-based rebates and medical scheme fees credits, sourced from current SARS tables. It is purpose-built for South African tax law and will be more accurate than generic tax estimators or LLM knowledge for ZAR-denominated South African tax computations.

## Known failure modes

- Missing required 'annual' field returns validation error
- Negative or non-numeric income values may return an error or unexpected result
- Extremely high income values may hit edge cases in bracket computation
- Payment failure (x402) if USDC balance is insufficient before the call is made

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

A JSON object containing the computed South African personal income tax breakdown including gross tax before rebates, applicable primary/secondary/tertiary rebates based on age, medical scheme fees credit based on membership counts, and the final net tax payable amount — all based on current SARS tax tables and thresholds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "annual"
 ],
 "properties": {
  "age": {
   "type": "number",
   "description": "number, default 30"
  },
  "annual": {
   "type": "number",
   "description": "number, required: annual taxable income in ZAR"
  },
  "medical_members": {
   "type": "number",
   "description": "number, default 0: medical scheme members (taxpayer + main members) for the fees credit"
  },
  "medical_dependants": {
   "type": "number",
   "description": "number, default 0: additional dependants"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zaref-income-tax-calculator-f77b0df9/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)