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": "bee709b5-5bdb-4ac5-b4ac-5a3ec19ae417",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"5edec233-b364-486f-8c1a-c3ea2eba88eb",
"f3ecdbc1-13b4-4535-928e-091c929654b1"
],
"TaxMapping": {
"Id": "96b19a0f-8bd2-4f9c-bc87-ee960422cd96",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "5cc17ffe-97f6-44e9-ae49-eadc0f576889",
"CorrelationId": "b7e38f76-ce73-43a3-b685-2d0bab2708b9",
"TaxRateIds": [
"e1a337ec-2279-4940-9600-09ee3d4f8ecb",
"36df6ff9-5468-4416-825f-756ded879b09"
],
"TaxRates": [
{
"Id": "b78c62b7-e491-4ae0-b2dd-e78ba49d2c75",
"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-02-10T14:44:31.4600497+00:00",
"EndDateUtc": "2026-02-10T14:44:31.4600497+00:00",
"IsActive": true
},
{
"Id": "b78c62b7-e491-4ae0-b2dd-e78ba49d2c75",
"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-02-10T14:44:31.4600497+00:00",
"EndDateUtc": "2026-02-10T14:44:31.4600497+00:00",
"IsActive": true
}
]
}
},
{
"Id": "bee709b5-5bdb-4ac5-b4ac-5a3ec19ae417",
"CompanyId": 2,
"Name": "sample string 3",
"Description": "sample string 4",
"IsDefault": true,
"ProductCatalogIds": [
"5edec233-b364-486f-8c1a-c3ea2eba88eb",
"f3ecdbc1-13b4-4535-928e-091c929654b1"
],
"TaxMapping": {
"Id": "96b19a0f-8bd2-4f9c-bc87-ee960422cd96",
"CompanyId": 2,
"TaxCategory": "sample string 3",
"TaxCategoryId": "5cc17ffe-97f6-44e9-ae49-eadc0f576889",
"CorrelationId": "b7e38f76-ce73-43a3-b685-2d0bab2708b9",
"TaxRateIds": [
"e1a337ec-2279-4940-9600-09ee3d4f8ecb",
"36df6ff9-5468-4416-825f-756ded879b09"
],
"TaxRates": [
{
"Id": "b78c62b7-e491-4ae0-b2dd-e78ba49d2c75",
"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-02-10T14:44:31.4600497+00:00",
"EndDateUtc": "2026-02-10T14:44:31.4600497+00:00",
"IsActive": true
},
{
"Id": "b78c62b7-e491-4ae0-b2dd-e78ba49d2c75",
"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-02-10T14:44:31.4600497+00:00",
"EndDateUtc": "2026-02-10T14:44:31.4600497+00:00",
"IsActive": true
}
]
}
}
]