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": "3f179465-8714-47be-ac91-9b5afcbbf43c",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"300b808d-3c93-4f28-9812-18a89bbc8359",
"f9999b7e-0b5c-4cc8-bd55-0f29d217aa75"
],
"TaxMapping": {
"Id": "98cb7971-6cd4-4a03-b38b-54c55abe13d9",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "5151b701-06e2-494e-ab03-231ffb290207",
"CorrelationId": "d4eea126-5938-4f7c-90b2-c8086bedecfd",
"TaxRateIds": [
"51ce1e8a-5dab-4993-ba8d-862cb6c83a9c",
"671ac825-ee06-4d52-b0ec-984e0d517781"
],
"TaxRates": [
{
"Id": "4f1464fa-2faf-4b09-bfe1-b3023552153c",
"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-11-19T10:43:59.584736+00:00",
"EndDateUtc": "2026-11-19T10:43:59.584736+00:00",
"IsActive": true
},
{
"Id": "4f1464fa-2faf-4b09-bfe1-b3023552153c",
"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-11-19T10:43:59.584736+00:00",
"EndDateUtc": "2026-11-19T10:43:59.584736+00:00",
"IsActive": true
}
]
}
},
{
"Id": "3f179465-8714-47be-ac91-9b5afcbbf43c",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"300b808d-3c93-4f28-9812-18a89bbc8359",
"f9999b7e-0b5c-4cc8-bd55-0f29d217aa75"
],
"TaxMapping": {
"Id": "98cb7971-6cd4-4a03-b38b-54c55abe13d9",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "5151b701-06e2-494e-ab03-231ffb290207",
"CorrelationId": "d4eea126-5938-4f7c-90b2-c8086bedecfd",
"TaxRateIds": [
"51ce1e8a-5dab-4993-ba8d-862cb6c83a9c",
"671ac825-ee06-4d52-b0ec-984e0d517781"
],
"TaxRates": [
{
"Id": "4f1464fa-2faf-4b09-bfe1-b3023552153c",
"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-11-19T10:43:59.584736+00:00",
"EndDateUtc": "2026-11-19T10:43:59.584736+00:00",
"IsActive": true
},
{
"Id": "4f1464fa-2faf-4b09-bfe1-b3023552153c",
"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-11-19T10:43:59.584736+00:00",
"EndDateUtc": "2026-11-19T10:43:59.584736+00:00",
"IsActive": true
}
]
}
}
]