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": "2cd337b6-3def-4656-aaf8-f6a61f904811",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"5875ffb7-71cb-4eb2-966a-890671da30ee",
"98dd014c-c469-415c-a4ec-b75b7a8851b7"
],
"TaxMapping": {
"Id": "5a8bc9f8-33c5-4285-8187-3d9ed162a637",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "aa4c2b1e-e67b-4c95-9df9-04e58dad833f",
"CorrelationId": "5274485d-06ca-4d52-812b-085121972660",
"TaxRateIds": [
"6f324267-932c-4e7f-a44b-ef168d8369ce",
"c85a4ecd-2f27-4a90-9efb-996f50f66f1a"
],
"TaxRates": [
{
"Id": "3387e8e8-6873-4dbe-a01d-93c91ce3ace2",
"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-13T14:59:59.3266912+00:00",
"EndDateUtc": "2026-10-13T14:59:59.3266912+00:00",
"IsActive": true
},
{
"Id": "3387e8e8-6873-4dbe-a01d-93c91ce3ace2",
"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-13T14:59:59.3266912+00:00",
"EndDateUtc": "2026-10-13T14:59:59.3266912+00:00",
"IsActive": true
}
]
}
},
{
"Id": "2cd337b6-3def-4656-aaf8-f6a61f904811",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"5875ffb7-71cb-4eb2-966a-890671da30ee",
"98dd014c-c469-415c-a4ec-b75b7a8851b7"
],
"TaxMapping": {
"Id": "5a8bc9f8-33c5-4285-8187-3d9ed162a637",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "aa4c2b1e-e67b-4c95-9df9-04e58dad833f",
"CorrelationId": "5274485d-06ca-4d52-812b-085121972660",
"TaxRateIds": [
"6f324267-932c-4e7f-a44b-ef168d8369ce",
"c85a4ecd-2f27-4a90-9efb-996f50f66f1a"
],
"TaxRates": [
{
"Id": "3387e8e8-6873-4dbe-a01d-93c91ce3ace2",
"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-13T14:59:59.3266912+00:00",
"EndDateUtc": "2026-10-13T14:59:59.3266912+00:00",
"IsActive": true
},
{
"Id": "3387e8e8-6873-4dbe-a01d-93c91ce3ace2",
"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-13T14:59:59.3266912+00:00",
"EndDateUtc": "2026-10-13T14:59:59.3266912+00:00",
"IsActive": true
}
]
}
}
]