Get FIRS Invoice Types
Get FIRS Invoice Types
Retrieve available invoice types for a specific business.
Quick Reference
| Method | Endpoint | Authentication Required |
|---|---|---|
| GET | https://api-dev.nairainvoice.com/dev/external/businesses/:businessId/resources/invoice-types | 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
Invoice Type Object
| Field | Type | Description |
|---|---|---|
| code | string | FIRS invoice type code |
| value | string | Descriptive name of the invoice type |
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 invoice type codes) - GET
/businesses//settings– Get business configuration
This endpoint provides FIRS-compliant invoice types for businesses to use when creating invoices.
Request
Path Params
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| stage | string | required | – | |
| businessId | string | required | (Required) businessId |
Header Params
| Header Params | Type | Required | Description | Example |
|---|---|---|---|---|
| X-Business-Key | string | required | (Required) X-Business-Key | BK-26EDE24BAC50475FAACC5EA6339F0863-DEV-B2Z6QCEHI3X9 |
| Accept | string | required | — | */* |
