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": "e1a02a77-2ab8-499c-abc6-c7c5344d1525",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"214c6a4d-53f4-4267-8dd4-3a9c25963d4b",
"aafe7e3d-3b60-41dd-88f0-0d5886d9332e"
],
"TaxMapping": {
"Id": "1a2db41e-fd20-42c0-85bc-08a0e46360ed",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "184e2523-ac2a-4e2a-9915-df8172a382f3",
"CorrelationId": "149a3b6e-9d79-429a-b385-0a33954d9742",
"TaxRateIds": [
"35f38afa-25d3-4521-8359-82c726be3cd2",
"e4c9223a-0550-46c0-99f0-79f4ac5ccbf4"
],
"TaxRates": [
{
"Id": "819e34cd-95d8-47f7-bac5-67f8e0077104",
"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-07-26T19:00:59.5212954+00:00",
"EndDateUtc": "2026-07-26T19:00:59.5212954+00:00",
"IsActive": true
},
{
"Id": "819e34cd-95d8-47f7-bac5-67f8e0077104",
"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-07-26T19:00:59.5212954+00:00",
"EndDateUtc": "2026-07-26T19:00:59.5212954+00:00",
"IsActive": true
}
]
}
},
{
"Id": "e1a02a77-2ab8-499c-abc6-c7c5344d1525",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"214c6a4d-53f4-4267-8dd4-3a9c25963d4b",
"aafe7e3d-3b60-41dd-88f0-0d5886d9332e"
],
"TaxMapping": {
"Id": "1a2db41e-fd20-42c0-85bc-08a0e46360ed",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "184e2523-ac2a-4e2a-9915-df8172a382f3",
"CorrelationId": "149a3b6e-9d79-429a-b385-0a33954d9742",
"TaxRateIds": [
"35f38afa-25d3-4521-8359-82c726be3cd2",
"e4c9223a-0550-46c0-99f0-79f4ac5ccbf4"
],
"TaxRates": [
{
"Id": "819e34cd-95d8-47f7-bac5-67f8e0077104",
"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-07-26T19:00:59.5212954+00:00",
"EndDateUtc": "2026-07-26T19:00:59.5212954+00:00",
"IsActive": true
},
{
"Id": "819e34cd-95d8-47f7-bac5-67f8e0077104",
"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-07-26T19:00:59.5212954+00:00",
"EndDateUtc": "2026-07-26T19:00:59.5212954+00:00",
"IsActive": true
}
]
}
}
]