GET v1/Companies({CompanyId})/TaxCategories
Returns all Tax Categories for a Company
Information:
Base URL:
https://api.covasoft.net/taxes
Example of a call would be:
https://api.covasoft.net/taxes/v1/Companies({CompanyId})/TaxCategories
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| CompanyId |
The unique Company Id that was provided in your onboarding pacakage |
integer |
Required |
Body Parameters
None.
Response Information
Resource Description
All the Tax Categories for a Company
Collection of TaxCategory| Name | Description | Type | Additional information |
|---|---|---|---|
| Id | globally unique identifier |
None. |
|
| CompanyId | integer |
None. |
|
| Name | string |
None. |
|
| Description | string |
None. |
|
| IsDefault | boolean |
None. |
|
| ProductCatalogIds | Collection of globally unique identifier |
None. |
|
| TaxMapping | TaxMapping |
None. |
Response Formats
application/json, text/json
Sample:
[
{
"Id": "5b8fb905-57b7-4689-9c6e-e467683d9951",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"1ec821bb-46d7-4664-83f1-36fe3b1fee4e",
"792ab8e1-5023-4250-9f15-bc24442d236d"
],
"TaxMapping": {
"Id": "97436168-deb0-4b8c-b62a-1a4bf2242841",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "31e12654-f24f-4195-818b-36b33cbc45c7",
"CorrelationId": "508196e2-9c99-4b1e-bba8-3863a66a5187",
"TaxRateIds": [
"d2d0f19f-84cd-48ee-b30d-b734535265d2",
"963dfc2b-210f-4ad1-9ad6-4458fa1a51f5"
],
"TaxRates": [
{
"Id": "ec1e9f70-8993-4e3c-bab8-3f7ab2fafcad",
"CompanyId": 2,
"Name": "sample string 3",
"DisplayName": "sample string 4",
"Description": "sample string 5",
"Rate": 6.1,
"TaxRateType": "sample string 7",
"TaxCalculatedOn": "sample string 8",
"Layer": 9,
"StartDateUtc": "2025-12-11T17:15:30.6839461+00:00",
"EndDateUtc": "2025-12-11T17:15:30.6839461+00:00",
"IsActive": true
},
{
"Id": "ec1e9f70-8993-4e3c-bab8-3f7ab2fafcad",
"CompanyId": 2,
"Name": "sample string 3",
"DisplayName": "sample string 4",
"Description": "sample string 5",
"Rate": 6.1,
"TaxRateType": "sample string 7",
"TaxCalculatedOn": "sample string 8",
"Layer": 9,
"StartDateUtc": "2025-12-11T17:15:30.6839461+00:00",
"EndDateUtc": "2025-12-11T17:15:30.6839461+00:00",
"IsActive": true
}
]
}
},
{
"Id": "5b8fb905-57b7-4689-9c6e-e467683d9951",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"1ec821bb-46d7-4664-83f1-36fe3b1fee4e",
"792ab8e1-5023-4250-9f15-bc24442d236d"
],
"TaxMapping": {
"Id": "97436168-deb0-4b8c-b62a-1a4bf2242841",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "31e12654-f24f-4195-818b-36b33cbc45c7",
"CorrelationId": "508196e2-9c99-4b1e-bba8-3863a66a5187",
"TaxRateIds": [
"d2d0f19f-84cd-48ee-b30d-b734535265d2",
"963dfc2b-210f-4ad1-9ad6-4458fa1a51f5"
],
"TaxRates": [
{
"Id": "ec1e9f70-8993-4e3c-bab8-3f7ab2fafcad",
"CompanyId": 2,
"Name": "sample string 3",
"DisplayName": "sample string 4",
"Description": "sample string 5",
"Rate": 6.1,
"TaxRateType": "sample string 7",
"TaxCalculatedOn": "sample string 8",
"Layer": 9,
"StartDateUtc": "2025-12-11T17:15:30.6839461+00:00",
"EndDateUtc": "2025-12-11T17:15:30.6839461+00:00",
"IsActive": true
},
{
"Id": "ec1e9f70-8993-4e3c-bab8-3f7ab2fafcad",
"CompanyId": 2,
"Name": "sample string 3",
"DisplayName": "sample string 4",
"Description": "sample string 5",
"Rate": 6.1,
"TaxRateType": "sample string 7",
"TaxCalculatedOn": "sample string 8",
"Layer": 9,
"StartDateUtc": "2025-12-11T17:15:30.6839461+00:00",
"EndDateUtc": "2025-12-11T17:15:30.6839461+00:00",
"IsActive": true
}
]
}
}
]