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": "22c1be55-9598-4835-8dc1-9a7dbba1e127",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"b43a4e32-44b8-4aef-9b53-e4b14b2c8652",
"da9ed9b9-2385-4cdd-8062-d703fdfbc9f1"
],
"TaxMapping": {
"Id": "3e303858-37d3-41b2-91eb-d53d96cf1928",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "d9441905-bf3b-415f-a783-fa025d39dfef",
"CorrelationId": "9e15c86d-cd95-4616-b750-a913c370e436",
"TaxRateIds": [
"d846815b-0c11-4e7b-aa5d-7b5a56e98e42",
"abb64486-a8dc-4395-8275-1ac393001fdf"
],
"TaxRates": [
{
"Id": "25fe4ffe-8a43-48ad-83c1-8691db1a1a57",
"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-10-29T13:17:44.1524927+00:00",
"EndDateUtc": "2026-10-29T13:17:44.1524927+00:00",
"IsActive": true
},
{
"Id": "25fe4ffe-8a43-48ad-83c1-8691db1a1a57",
"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-10-29T13:17:44.1524927+00:00",
"EndDateUtc": "2026-10-29T13:17:44.1524927+00:00",
"IsActive": true
}
]
}
},
{
"Id": "22c1be55-9598-4835-8dc1-9a7dbba1e127",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"b43a4e32-44b8-4aef-9b53-e4b14b2c8652",
"da9ed9b9-2385-4cdd-8062-d703fdfbc9f1"
],
"TaxMapping": {
"Id": "3e303858-37d3-41b2-91eb-d53d96cf1928",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "d9441905-bf3b-415f-a783-fa025d39dfef",
"CorrelationId": "9e15c86d-cd95-4616-b750-a913c370e436",
"TaxRateIds": [
"d846815b-0c11-4e7b-aa5d-7b5a56e98e42",
"abb64486-a8dc-4395-8275-1ac393001fdf"
],
"TaxRates": [
{
"Id": "25fe4ffe-8a43-48ad-83c1-8691db1a1a57",
"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-10-29T13:17:44.1524927+00:00",
"EndDateUtc": "2026-10-29T13:17:44.1524927+00:00",
"IsActive": true
},
{
"Id": "25fe4ffe-8a43-48ad-83c1-8691db1a1a57",
"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-10-29T13:17:44.1524927+00:00",
"EndDateUtc": "2026-10-29T13:17:44.1524927+00:00",
"IsActive": true
}
]
}
}
]