List PAYE bands

GET/payroll/paye-bands

Returns all configured income tax (PAYE) rate bands for the tenant's jurisdiction, ordered by lower-bound income threshold.

Request

This endpoint takes no parameters and no request body.

Responses

200 List of PAYE bands

Content type application/json, array of object · PayeBandV1.

Field	Type	Required	Description
id	integer	No
description	string	No	Human-readable description of the band (e.g. "First GHS 401/month").
lower_bound	number (float)	No	Minimum monthly income (inclusive) for this band in the configured currency.
upper_bound	number (float), nullable	No	Maximum monthly income (exclusive) for this band. Null for the top-rate band (no upper limit).
rate	number (float)	No	Tax rate as a percentage (e.g. 10.0 for 10%).

Example

[
  {
    "id": 1,
    "description": "First GHS 401/month",
    "lower_bound": 0.0,
    "upper_bound": 401.0,
    "rate": 0.0
  },
  {
    "id": 2,
    "description": "Next GHS 109",
    "lower_bound": 401.0,
    "upper_bound": 510.0,
    "rate": 5.0
  }
]

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/payroll/paye-bands" \
  -H "Accept: application/json"