Get NRS Tax Categories

GET

/{stage}/external/{businessId}/resources/tax-categories

Retrieve available tax categories.

Quick Reference

Method	Endpoint	Authentication Required
`GET`	`{{baseUrl}}/{{stage}}/external/businesses/:businessId/resources/tax-categories`	Yes

Request Structure

Path Parameters

Parameter	Type	Required	Description	Example
`businessId`	string	✅	Unique identifier of the business whose tax categories are being retrieved	`26ede24b-ac50-475f-aacc-5ea6339f0863`

Headers

Header	Value	Required
`Content-Type`	`application/json` or `/`	Yes
`Accept`	`application/json` or `/`	Yes
`X-Business-Key`	`businessKey`	Yes

Response Format

Success Response (200)

{
  "responseCode": "00",
  "responseMessage": "Tax categories retrieved successfully",
  "data": [
    {
      "code": "STANDARD_VAT",
      "value": "Standard Value-Added Tax"
    },
    {
      "code": "ZERO_VAT",
      "value": "Zero Value-Added Tax"
    },
    {
      "code": "EXEMPT_VAT",
      "value": "Exempt Value-Added Tax"
    },
    {
      "code": "STANDARD_GST",
      "value": "Standard Goods and Services Tax"
    }
  ]
}

Request

Path Params

Header Params

Responses

🟢200OK

text/plain

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '/{{stage}}/external/{{businessId}}/resources/tax-categories' \
--header 'X-Business-Key: BK-26EDE24BAC50475FAACC5EA6339F0863-DEV-B2Z6QCEHI3X9' \
--header 'Accept: */*'

Response Example

{
    "responseCode": "00",
    "responseMessage": "Completed successfully",
    "data": [
        {
            "code": "STANDARD_GST",
            "value": "Standard Goods and Services Tax"
        },
        {
            "code": "REDUCED_GST",
            "value": "Reduced Goods and Services Tax"
        },
        {
            "code": "ZERO_GST",
            "value": "Zero Goods and Services Tax"
        },
        {
            "code": "STANDARD_VAT",
            "value": "Standard Value-Added Tax"
        },
        {
            "code": "REDUCED_VAT",
            "value": "Reduced Value-Added Tax"
        },
        {
            "code": "ZERO_VAT",
            "value": "Zero Value-Added Tax"
        },
        {
            "code": "STATE_SALES_TAX",
            "value": "State Sales Tax"
        },
        {
            "code": "LOCAL_SALES_TAX",
            "value": "Local Sales Tax"
        },
        {
            "code": "ALCOHOL_EXCISE_TAX",
            "value": "Alcohol Excise Tax"
        },
        {
            "code": "TOBACCO_EXCISE_TAX",
            "value": "Tobacco Excise Tax"
        },
        {
            "code": "FUEL_EXCISE_TAX",
            "value": "Fuel Excise Tax"
        },
        {
            "code": "CORPORATE_INCOME_TAX",
            "value": "Corporate Income Tax"
        },
        {
            "code": "PERSONAL_INCOME_TAX",
            "value": "Personal Income Tax"
        },
        {
            "code": "SOCIAL_SECURITY_TAX",
            "value": "Social Security Tax"
        },
        {
            "code": "MEDICARE_TAX",
            "value": "Medicare Tax"
        },
        {
            "code": "REAL_ESTATE_TAX",
            "value": "Real Estate Tax"
        },
        {
            "code": "PERSONAL_PROPERTY_TAX",
            "value": "Personal Property Tax"
        },
        {
            "code": "CARBON_TAX",
            "value": "Carbon Tax"
        },
        {
            "code": "PLASTIC_TAX",
            "value": "Plastic Tax"
        },
        {
            "code": "IMPORT_DUTY",
            "value": "Import Duty"
        },
        {
            "code": "EXPORT_DUTY",
            "value": "Export Duty"
        },
        {
            "code": "LUXURY_TAX",
            "value": "Luxury Tax"
        },
        {
            "code": "SERVICE_TAX",
            "value": "Service Tax"
        },
        {
            "code": "TOURISM_TAX",
            "value": "Tourism Tax"
        },
        {
            "code": "WITHHOLDING_TAX",
            "value": "Withholding Tax"
        },
        {
            "code": "STAMP_DUTY",
            "value": "Stamp Duty"
        },
        {
            "code": "EXEMPTED",
            "value": "Tax Exemption"
        }
    ]
}

Modified at 2026-08-21 09:28:49

Get NRS Service Codes

Get NRS Tax Categories

Quick Reference#

Request Structure#

Path Parameters#

Headers#

Response Format#

Success Response (200)#