Skip to content
Category

Run Angola payroll estimates for employee and employer views.

The salary family applies internal Angola payroll assumptions for employee social security, employer social security, and employment-income withholding tables for supported years.

Routes

3 GET

Years

2025 and 2026

Outputs

Net, gross, employer cost

Routes in this family

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

GET /api/v1/salary/net

Use net when your source value is the gross salary and you want the estimated take-home amount.

ParameterRequiredDescription
grossYesGross monthly salary.
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=500000&year=2026"
JSON200 response
{  "currency": "AOA",  "year": 2026,  "grossSalary": 500000,  "taxableIncome": 485000,  "employeeSocialSecurity": 15000,  "irtRate": 16,  "irtTaxAmount": 52100,  "netSalary": 432900,  "employerContribution": 40000,  "assumptions": ["Applies monthly employment-income withholding for Angola."]}
JSONError response
{  "error": {    "code": "UNSUPPORTED_TAX_YEAR",    "message": "Supported salary-tax years are 2025 and 2026.",    "year": 2024  }}

GET /api/v1/salary/gross

Use gross when the target value is net pay and you need the approximate gross salary required to reach it.

ParameterRequiredDescription
netYesDesired net monthly salary.
yearNoSupported tax year. Defaults to `2026`.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/salary/gross?net=432900&year=2026"
JSON200 response
{  "currency": "AOA",  "year": 2026,  "targetNetSalary": 432900,  "grossSalary": 500000,  "employeeSocialSecurity": 15000,  "irtTaxAmount": 52100,  "netSalary": 432900}
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 employee gross salary.

ParameterRequiredDescription
grossYesGross monthly salary.
yearNoSupported tax year. Defaults to `2026`.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/salary/employer-cost?gross=500000&year=2026"
JSON200 response
{  "currency": "AOA",  "year": 2026,  "grossSalary": 500000,  "employerContribution": 40000,  "totalEmployerCost": 540000}
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 in any UI that shows the result.