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": "96cded8b-2b8b-4c92-aed0-a1ac3b723188",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"2ada9a69-c8d9-4def-8229-9fe268fa4a65",
"aa4d1a17-aca3-4b37-a151-e8e7fe4ff3f8"
],
"TaxMapping": {
"Id": "d146f871-b7c1-4748-8012-3c42ab49de3f",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "3f4672dc-cee9-4511-8b09-e76fa94a33ab",
"CorrelationId": "42fe41e3-c3f0-47a5-94f0-305fa39aa365",
"TaxRateIds": [
"1d2b545c-5e26-477c-9b0d-1f3b374921d6",
"2a77a24e-e077-49e6-b32f-46c7abd08e2b"
],
"TaxRates": [
{
"Id": "d594d565-3fa4-42dc-a14a-ae1f41fbc02a",
"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-31T20:51:20.5157667+00:00",
"EndDateUtc": "2025-12-31T20:51:20.5157667+00:00",
"IsActive": true
},
{
"Id": "d594d565-3fa4-42dc-a14a-ae1f41fbc02a",
"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-31T20:51:20.5157667+00:00",
"EndDateUtc": "2025-12-31T20:51:20.5157667+00:00",
"IsActive": true
}
]
}
},
{
"Id": "96cded8b-2b8b-4c92-aed0-a1ac3b723188",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"2ada9a69-c8d9-4def-8229-9fe268fa4a65",
"aa4d1a17-aca3-4b37-a151-e8e7fe4ff3f8"
],
"TaxMapping": {
"Id": "d146f871-b7c1-4748-8012-3c42ab49de3f",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "3f4672dc-cee9-4511-8b09-e76fa94a33ab",
"CorrelationId": "42fe41e3-c3f0-47a5-94f0-305fa39aa365",
"TaxRateIds": [
"1d2b545c-5e26-477c-9b0d-1f3b374921d6",
"2a77a24e-e077-49e6-b32f-46c7abd08e2b"
],
"TaxRates": [
{
"Id": "d594d565-3fa4-42dc-a14a-ae1f41fbc02a",
"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-31T20:51:20.5157667+00:00",
"EndDateUtc": "2025-12-31T20:51:20.5157667+00:00",
"IsActive": true
},
{
"Id": "d594d565-3fa4-42dc-a14a-ae1f41fbc02a",
"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-31T20:51:20.5157667+00:00",
"EndDateUtc": "2025-12-31T20:51:20.5157667+00:00",
"IsActive": true
}
]
}
}
]