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": "dd316254-294b-4bc2-bdcb-847ee1515d51",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"c623f530-e25d-4696-a800-52d3458d5d7f",
"023a6aaa-bf16-4412-82a5-c96972dd46ab"
],
"TaxMapping": {
"Id": "5816aed9-8bb4-4c61-8363-2ab07550ab97",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "e48d2ac9-9ed4-4e6f-89ed-8b5263f0908a",
"CorrelationId": "ed5ac41a-ba2b-4de4-87df-71d8a8c1a8ee",
"TaxRateIds": [
"309a2358-7e0c-4972-b5c9-33d7a7072d44",
"b40dd7fe-2902-4b87-9e5c-8dea4c0a81bb"
],
"TaxRates": [
{
"Id": "1eeea51c-0707-4b5c-842f-d35d3fddebaf",
"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": "2026-08-04T17:07:29.235147+00:00",
"EndDateUtc": "2026-08-04T17:07:29.235147+00:00",
"IsActive": true
},
{
"Id": "1eeea51c-0707-4b5c-842f-d35d3fddebaf",
"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": "2026-08-04T17:07:29.235147+00:00",
"EndDateUtc": "2026-08-04T17:07:29.235147+00:00",
"IsActive": true
}
]
}
},
{
"Id": "dd316254-294b-4bc2-bdcb-847ee1515d51",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"c623f530-e25d-4696-a800-52d3458d5d7f",
"023a6aaa-bf16-4412-82a5-c96972dd46ab"
],
"TaxMapping": {
"Id": "5816aed9-8bb4-4c61-8363-2ab07550ab97",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "e48d2ac9-9ed4-4e6f-89ed-8b5263f0908a",
"CorrelationId": "ed5ac41a-ba2b-4de4-87df-71d8a8c1a8ee",
"TaxRateIds": [
"309a2358-7e0c-4972-b5c9-33d7a7072d44",
"b40dd7fe-2902-4b87-9e5c-8dea4c0a81bb"
],
"TaxRates": [
{
"Id": "1eeea51c-0707-4b5c-842f-d35d3fddebaf",
"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": "2026-08-04T17:07:29.235147+00:00",
"EndDateUtc": "2026-08-04T17:07:29.235147+00:00",
"IsActive": true
},
{
"Id": "1eeea51c-0707-4b5c-842f-d35d3fddebaf",
"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": "2026-08-04T17:07:29.235147+00:00",
"EndDateUtc": "2026-08-04T17:07:29.235147+00:00",
"IsActive": true
}
]
}
}
]