Skip to content
Category

Run Angola payroll estimates with 2025 and 2026 tax tables plus subsidy support.

The salary family applies Angola payroll assumptions for employee social security, employer social security, the supported IRT tables, and food or transport subsidies with monthly or daily input modes. The 2026 calculator is aligned to the current AGT simulator outputs, including bracket labeling and payroll-step rounding.

Routes

3 GET

Years

2025 and 2026

Subsidies

Meal and transport

Routes in this family

RoutePurposeKey query
/api/v1/salary/netEstimate take-home salary from gross salary.gross, year, mealSubsidy, transportSubsidy, subsidyPeriod
/api/v1/salary/grossEstimate the required gross salary for a target net.net, year, mealSubsidy, transportSubsidy, subsidyPeriod
/api/v1/salary/employer-costEstimate employer cost including contributions.gross, year, mealSubsidy, transportSubsidy, subsidyPeriod

GET /api/v1/salary/net

Use net when your source value is the monthly base gross salary and you want the estimated take-home amount including optional subsidies.

  • Food and transport subsidies each receive their own monthly IRT exemption cap of Kz 30,000.
  • Daily subsidy inputs are converted with a fixed 22-working-day month.
  • Social security still applies to contributory remuneration before the IRT subsidy exemptions are deducted.
  • The 2026 bracket metadata is aligned to the current AGT simulator outputs, which can differ from simplified secondary summaries.
ParameterRequiredDescription
grossYesBase gross monthly salary before optional subsidies.
mealSubsidyNoMeal subsidy value. Defaults to `0`.
transportSubsidyNoTransport subsidy value. Defaults to `0`.
subsidyPeriodNoUse `month` for monthly subsidy inputs or `day` to multiply the subsidy by `22` working days. Defaults to `month`.
yearNoSupported tax year. Currently `2025` or `2026`. Defaults to `2026`.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/salary/net?gross=1500000&mealSubsidy=4747.77&transportSubsidy=3160&subsidyPeriod=day&year=2026"
JSON200 response
{  "currency": "AOA",  "year": 2026,  "grossSalary": 1500000,  "totalGrossCompensation": 1673970.94,  "taxableIncomeBeforeExemptions": 1623751.81,  "taxableIncome": 1563751.81,  "employeeSocialSecurity": 50219.13,  "subsidies": {    "subsidyPeriod": "day",    "workingDaysApplied": 22,    "mealSubsidy": {      "inputAmount": 4747.77,      "monthlyAmount": 104450.94,      "exemptAmount": 30000,      "taxableAmount": 74450.94    },    "transportSubsidy": {      "inputAmount": 3160,      "monthlyAmount": 69520,      "exemptAmount": 30000,      "taxableAmount": 39520    }  },  "irtBracket": 8,  "irtRate": 22,  "irtTaxAmount": 306274.18,  "netSalary": 1317477.63,  "employerContribution": 133917.68}
JSONError response
{  "error": {    "code": "INVALID_ENUM",    "message": "The \"subsidyPeriod\" query parameter must be one of: month, day.",    "field": "subsidyPeriod",    "value": "weekly"  }}

GET /api/v1/salary/gross

Use gross when the target value is total take-home pay and you need the approximate base gross salary required to reach it with the given subsidies.

ParameterRequiredDescription
netYesDesired total net monthly salary.
mealSubsidyNoMeal subsidy value. Defaults to `0`.
transportSubsidyNoTransport subsidy value. Defaults to `0`.
subsidyPeriodNoUse `month` or `day`. Daily mode multiplies each subsidy by `22`.
yearNoSupported tax year. Defaults to `2026`.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/salary/gross?net=450000&mealSubsidy=25000&transportSubsidy=15000&subsidyPeriod=month&year=2026"
JSON200 response
{  "currency": "AOA",  "year": 2026,  "targetNetSalary": 450000,  "grossSalary": 513200.72,  "totalGrossCompensation": 553200.72,  "employeeSocialSecurity": 16596.02,  "subsidies": {    "subsidyPeriod": "month",    "totalMonthlyAmount": 40000,    "totalExemptAmount": 40000  },  "irtTaxAmount": 86604.7,  "netSalary": 450000}
JSONError response
{  "error": {    "code": "INVALID_NUMBER",    "message": "The \"net\" query parameter must be a non-negative number.",    "field": "net",    "value": "-1"  }}

GET /api/v1/salary/employer-cost

Use employer-cost when payroll planning needs the company-side contribution on top of the base gross salary and optional subsidies.

ParameterRequiredDescription
grossYesBase gross monthly salary before optional subsidies.
mealSubsidyNoMeal subsidy value. Defaults to `0`.
transportSubsidyNoTransport subsidy value. Defaults to `0`.
subsidyPeriodNoUse `month` or `day`. Daily mode multiplies each subsidy by `22`.
yearNoSupported tax year. Defaults to `2026`.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/salary/employer-cost?gross=500000&mealSubsidy=25000&transportSubsidy=15000&subsidyPeriod=month&year=2026"
JSON200 response
{  "currency": "AOA",  "year": 2026,  "grossSalary": 500000,  "totalGrossCompensation": 540000,  "employerContribution": 43200,  "totalEmployerCost": 583200}
JSONError response
{  "error": {    "code": "INVALID_NUMBER",    "message": "The \"gross\" query parameter must be a non-negative number.",    "field": "gross",    "value": "abc"  }}
These endpoints are scenario calculators, not payroll-filing services. Surface the assumptions, tax year, and subsidy treatment in any UI that shows the result.