Get FIRS Tax Categories
Get FIRS Tax Categories API
Retrieve available tax categories for a specific business.
Quick Reference
| Method | Endpoint | Authentication Required |
|---|---|---|
| GET | https://api-dev.nairainvoice.com/dev/external/businesses/:businessId/resources/tax-categories | Yes |
Request Structure
Path Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| businessId | string | ✅ | Unique identifier of the business | 26ede24b-ac50-475f-aacc-5ea6339f0863 |
Response Format
Success Response (200)
Copy to Clipboard
Response Data Structure
Tax Category Object
| Field | Type | Description |
|---|---|---|
| code | string | Tax category code identifier |
| value | string | Descriptive name of the tax category |
Error Responses
| Error Code | Message | Description |
|---|---|---|
| 404 | Business not found | Business ID doesn’t exist |
| 403 | Access denied | User doesn’t have permission |
| 400 | Invalid business ID | Business ID format is invalid |
Example Error Response
Copy to Clipboard
Related Endpoints
- POST
/invoices– Create invoice (uses tax categories) - GET
/businesses//settings– Get business configuration
This endpoint provides FIRS-compliant tax categories for businesses to use in tax calculations and invoice creation.
Request
Path Params
| Parameter | Type | Required | Example |
|---|---|---|---|
| stage | string | required | |
| businessId | string | required (Required) businessId |
Header Params
| Parameter | Type | Required | Example |
|---|---|---|---|
| X-Business-Key | string | required (Required) X-Business-Key |
BK-26EDE24BAC50475FAACC5EA6339F0863-DEV-B2Z6QCEHI3X9 |
| Accept | string | required | */* |
