Employer cost at a future date
cost_next_yearUse this when the user budgets an employee for next year or a future date and asks how the statutory employer cost will move (e.g. "what will this hire in Brazil cost the employer in January 2027?"). Returns the cost today and at that date (by default 1 January of next year), at the same gross salary and exchange rate, applying only the enacted dated changes recorded for the country; changes announced in a budget come in a separate, flagged variant, and dates deduced from a source are flagged. A country whose changes are not tracked yet gets today's cost and "not yet tracked", never a projection. Amounts given in the local currency come back in it, with the USD in brackets. Data snapshot 2026-10-11. Cost comparison, not legal or tax advice.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| salary | No | Gross salary, a year unless salary_period is "month". Omit to use the country's example salary. | |
| country | Yes | ISO 3166-1 alpha-2 code ("DE") or country name ("Germany") | |
| on_date | No | Date of the projection, YYYY-MM-DD. Omit for 1 January of the year after the data snapshot. | |
| assumptions | No | Override an adjustable assumption the country declares, e.g. {"basic_share_of_gross": 0.6}. See `assumptions` in an employer_cost answer. | |
| salary_period | No | Whether the salary is a year (default) or a month. Pass a monthly salary as the user gives it, with "month": the statutory number of monthly payments of the country (13th, 14th month) is applied, see salary_basis in the answer. | year |
| salary_currency | No | Currency of `salary`: USD, or the local currency of the country | USD |
| payments_per_year | No | With salary_period "month" only: the total number of monthly salaries the contract pays in a year, statutory ones included (e.g. 14). Omit to use the statutory number of the country. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | ||
| flags | No | ||
| salary | Yes | ||
| country | Yes | ||
| current | Yes | ||
| on_date | Yes | ||
| reading | Yes | ||
| summary | Yes | ||
| coverage | No | ||
| tracking | Yes | ||
| projected | Yes | ||
| salary_basis | No | ||
| researched_on | No | ||
| with_budget_announced | No |