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": "80562918-4a7c-47b0-9457-ebce8b2003e3",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"df7279a7-921c-4e17-829f-4a2f5693f0d8",
"fa33be40-54e0-4562-879d-445ea2c592ca"
],
"TaxMapping": {
"Id": "b5329eac-0da2-4787-8028-2461e7fb103f",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "13164165-3a0c-45f5-a5e8-92735e84f7c1",
"CorrelationId": "45b50c77-90d5-44fd-9bc1-477060fd6028",
"TaxRateIds": [
"8493b694-e782-42e2-ac34-ae693fe89eeb",
"6b587d23-4e4d-4afa-a138-369d842dee51"
],
"TaxRates": [
{
"Id": "d5e2ba2f-042a-42b1-bea0-2d5ac1f6e423",
"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-13T13:25:04.4427086+00:00",
"EndDateUtc": "2026-10-13T13:25:04.4427086+00:00",
"IsActive": true
},
{
"Id": "d5e2ba2f-042a-42b1-bea0-2d5ac1f6e423",
"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-13T13:25:04.4427086+00:00",
"EndDateUtc": "2026-10-13T13:25:04.4427086+00:00",
"IsActive": true
}
]
}
},
{
"Id": "80562918-4a7c-47b0-9457-ebce8b2003e3",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"df7279a7-921c-4e17-829f-4a2f5693f0d8",
"fa33be40-54e0-4562-879d-445ea2c592ca"
],
"TaxMapping": {
"Id": "b5329eac-0da2-4787-8028-2461e7fb103f",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "13164165-3a0c-45f5-a5e8-92735e84f7c1",
"CorrelationId": "45b50c77-90d5-44fd-9bc1-477060fd6028",
"TaxRateIds": [
"8493b694-e782-42e2-ac34-ae693fe89eeb",
"6b587d23-4e4d-4afa-a138-369d842dee51"
],
"TaxRates": [
{
"Id": "d5e2ba2f-042a-42b1-bea0-2d5ac1f6e423",
"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-13T13:25:04.4427086+00:00",
"EndDateUtc": "2026-10-13T13:25:04.4427086+00:00",
"IsActive": true
},
{
"Id": "d5e2ba2f-042a-42b1-bea0-2d5ac1f6e423",
"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-13T13:25:04.4427086+00:00",
"EndDateUtc": "2026-10-13T13:25:04.4427086+00:00",
"IsActive": true
}
]
}
}
]