eurorefCountries › API

Gross-to-net payroll

Take-home pay after PAYE and the employee's mandatory statutory contributions, with each deduction cited to its instrument and any assumed pay composition disclosed. Nigeria and Kenya only — a payroll config has to be hand-verified before it can be trusted.

This endpoint takes a POST, because it computes an answer from values you supply — there is nothing to fetch at this URL. You are seeing this page because your browser asked for HTML; an API client gets a 405 with the same information as JSON.

Call it

curl -X POST https://euroref.dev/v1/answers/payroll \
  -H 'content-type: application/json' \
  -d '{"country":"ke","gross":150000,"period":"month"}'

Body fields: country, gross, period, basic, housing, transport, annual_rent, sector, nhis_premium, pensionable_pay, insurance_premium

Paid per call over x402 (USDC on Base) — no key, no signup. Invalid input and questions we cannot answer well are refused free, before the payment gate: you never pay to fail.

What sits behind the answer

Every computed answer is arithmetic on cited reference data. The underlying values each carry their official source, an effective date and a last-verified date, and each declares how it was obtained — see the country pages and source provenance. Results are labelled basis: "computed" and are not tax, legal or financial advice.

Free to inspect

/catalog — every country and series held · /llms.txt — endpoints, prices and example bodies · /openapi.json · /accuracy — where reference data is wrong, including ours