# JP Local Pack API — Japan Payroll Salary Calculator

> JP Local Pack API — Japan Payroll Salary Calculator is a paid API for AI agents from jp-local-pack-api.kasanegi123.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Calculates Japanese payroll deductions (income tax, health insurance, pension, employment insurance) from a monthly salary amount, applying NTA withholding tables and Kyokai Kenpo prefecture rates for a given fiscal year.

## Facts

- Endpoint: GET https://jp-local-pack-api.kasanegi123.workers.dev/api/payroll/calc-by-salary
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jp-local-pack-api-japan-payroll-salary-calculator-2fee79c6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TFDXWlP-IZGp6sUSTCbAI

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 jp-local-pack-api-japan-payroll-salary-calculator-2fee79c6
```

Example prompt: What would the take-home pay be for a 40-year-old employee in Tokyo (prefecture code 13) with no dependents earning 300,000 yen per month in FY2026 — break down the income tax withholding, health insurance, pension, and employment insurance deductions.

## When to prefer this

Use this endpoint when you need a quick, programmatic Japanese payroll deduction estimate for a specific monthly salary, age, dependent count, and prefecture without maintaining local copies of NTA withholding tables or Kyokai Kenpo rate sheets. Ideal for AI agents automating HR calculations, payslip previews, or benefits planning in a Japan office context. Not a substitute for certified tax accountant advice.

## Known failure modes

- HTTP 402 returned when X-PAYMENT header is absent or invalid — numeric fields return as 0 placeholders in shape preview
- Invalid or out-of-range prefecture code may produce incorrect or null health insurance rates
- Salary below floor or above ceiling triggers _floor_applied or _ceiling_applied flags in response
- Unsupported fiscal year may result in missing or stale table data
- Network timeout from Cloudflare Workers edge if origin D1 database is unavailable

## How this service works

Japan payroll / tax / social insurance / mynumber / corporate / invoice / holiday reference API for AI agents. x402 micropayments on Base. No API key.

## Output

Returns a JSON object with the computed net salary, itemized deductions (income tax withholding, health insurance employee share, pension employee share, employment insurance employee share), total deduction amount, the applicable rates for each deduction, the fiscal year, prefecture code, age, dependent count, and a disclaimer noting it is a reference calculation. The income_tax_basis field identifies the NTA monthly table clause used. Unpaid 402 preview returns 0-placeholder numeric fields.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fy": "2026",
  "age": 40,
  "_role": "shape_preview_echoes_query_for_paid_response",
  "pref_code": "13",
  "dependents": 0,
  "disclaimer": "Reference calculation only. Consult a certified tax accountant (zeirishi) for legal compliance.",
  "net_salary": 0,
  "attribution": "<data sources>",
  "_sample_note": "Unpaid 402 shape preview echoes the requested monthly_salary + age + dependents + pref_code; paid 200 computes deductions from D1 jpp_income_tax_table (NTA monthly table, Reiwa 8) + Kyokai Kenpo FY2026 prefecture rate.",
  "_floor_applied": false,
  "monthly_salary": 300000,
  "total_deduction": 0,
  "_ceiling_applied": false,
  "income_tax_basis": "monthly-table-ko-clause-2026",
  "pension_employee": 0,
  "pension_rate_pct": 9.15,
  "_shape_preview_note": "Numeric fields in this unpaid 402 shape preview are 0 placeholders. Real values require X-PAYMENT on production.",
  "income_tax_withholding": 0,
  "health_insurance_employee": 0,
  "health_insurance_rate_pct": 0,
  "employment_insurance_employee": 0,
  "employment_insurance_rate_pct": 0.5
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jp-local-pack-api-japan-payroll-salary-calculator-2fee79c6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from jp-local-pack-api.kasanegi123.workers.dev](https://www.zero.xyz/host/jp-local-pack-api.kasanegi123.workers.dev/llms.txt)