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": "b2e45848-f6a0-4c7d-aa79-6d5117bb78e2",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"8c1f0087-f5bb-4660-ab35-a9dcccc74b90",
"e536b229-d136-4eaf-85dc-1d95d8672296"
],
"TaxMapping": {
"Id": "f0dde673-03a8-45b7-9034-ad2ac631db6c",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "025e9c0a-eed7-4296-8899-cc7c7806b5f3",
"CorrelationId": "123238b1-8527-4e66-a9b5-6dc3d02e659d",
"TaxRateIds": [
"8200db3a-b1d2-4b75-ad5e-77886177fec7",
"711e893a-3d7a-47bb-a077-6acf63eb933c"
],
"TaxRates": [
{
"Id": "02707ebb-a10b-429b-b9e8-b0bd2fc0c6f8",
"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-05T02:51:49.7434347+00:00",
"EndDateUtc": "2026-08-05T02:51:49.7434347+00:00",
"IsActive": true
},
{
"Id": "02707ebb-a10b-429b-b9e8-b0bd2fc0c6f8",
"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-05T02:51:49.7434347+00:00",
"EndDateUtc": "2026-08-05T02:51:49.7434347+00:00",
"IsActive": true
}
]
}
},
{
"Id": "b2e45848-f6a0-4c7d-aa79-6d5117bb78e2",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"8c1f0087-f5bb-4660-ab35-a9dcccc74b90",
"e536b229-d136-4eaf-85dc-1d95d8672296"
],
"TaxMapping": {
"Id": "f0dde673-03a8-45b7-9034-ad2ac631db6c",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "025e9c0a-eed7-4296-8899-cc7c7806b5f3",
"CorrelationId": "123238b1-8527-4e66-a9b5-6dc3d02e659d",
"TaxRateIds": [
"8200db3a-b1d2-4b75-ad5e-77886177fec7",
"711e893a-3d7a-47bb-a077-6acf63eb933c"
],
"TaxRates": [
{
"Id": "02707ebb-a10b-429b-b9e8-b0bd2fc0c6f8",
"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-05T02:51:49.7434347+00:00",
"EndDateUtc": "2026-08-05T02:51:49.7434347+00:00",
"IsActive": true
},
{
"Id": "02707ebb-a10b-429b-b9e8-b0bd2fc0c6f8",
"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-05T02:51:49.7434347+00:00",
"EndDateUtc": "2026-08-05T02:51:49.7434347+00:00",
"IsActive": true
}
]
}
}
]